Interlocked.Exchange Methode

Definitie

Naamruimte:: System.Threading

Assembly's:: mscorlib.dll, System.Threading.dll

Assembly:: mscorlib.dll

Assembly:: System.Threading.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee stelt u een variabele in op een opgegeven waarde als atomische bewerking.

Overloads

Name	Description
Exchange(Single, Single)	Stelt een drijvendekommagetal met één precisie in op een opgegeven waarde en retourneert de oorspronkelijke waarde als een atomische bewerking.
Exchange(Object, Object)	Hiermee stelt u een object in op een opgegeven waarde en wordt een verwijzing naar het oorspronkelijke object geretourneerd als atomische bewerking.
Exchange(IntPtr, IntPtr)	Hiermee stelt u een geheel getal met een eigen grootte in op een opgegeven waarde en retourneert u de oorspronkelijke waarde als atomische bewerking.
Exchange(Double, Double)	Stelt een drijvendekommagetal met dubbele precisie in op een opgegeven waarde en retourneert de oorspronkelijke waarde als een atomische bewerking.
Exchange(Int32, Int32)	Stelt een 32-bits ondertekend geheel getal in op een opgegeven waarde en retourneert de oorspronkelijke waarde als een atomische bewerking.
Exchange(Int64, Int64)	Stelt een 64-bits ondertekend geheel getal in op een opgegeven waarde en retourneert de oorspronkelijke waarde als een atomische bewerking.
Exchange<T>(T, T)	Stelt een variabele van het opgegeven type `T` in op een opgegeven waarde en retourneert de oorspronkelijke waarde als atomische bewerking.

Exchange(Single, Single)

Stelt een drijvendekommagetal met één precisie in op een opgegeven waarde en retourneert de oorspronkelijke waarde als een atomische bewerking.

public:
 static float Exchange(float % location1, float value);

public static float Exchange(ref float location1, float value);

static member Exchange : single * single -> single

Public Shared Function Exchange (ByRef location1 As Single, value As Single) As Single

Parameters

location1: Single

De variabele die moet worden ingesteld op de opgegeven waarde.

value: Single

De waarde waarop de location1 parameter is ingesteld.

Retouren

Single

De oorspronkelijke waarde van location1.

Uitzonderingen

NullReferenceException

Het adres van location1 is een null aanwijzer.

Zie ook

Het Beheerd Draadbeheer
Overzicht van synchronisatie primitiefen

Van toepassing op

Exchange(Object, Object)

Hiermee stelt u een object in op een opgegeven waarde en wordt een verwijzing naar het oorspronkelijke object geretourneerd als atomische bewerking.

public:
 static System::Object ^ Exchange(System::Object ^ % location1, System::Object ^ value);

public static object Exchange(ref object location1, object value);

static member Exchange : obj * obj -> obj

Public Shared Function Exchange (ByRef location1 As Object, value As Object) As Object

Parameters

location1: Object

De variabele die moet worden ingesteld op de opgegeven waarde.

value: Object

De waarde waarop de location1 parameter is ingesteld.

Retouren

Object

De oorspronkelijke waarde van location1.

Uitzonderingen

ArgumentNullException

Het adres van location1 is een null aanwijzer.

NullReferenceException

Het adres van location1 is een null aanwijzer.

Opmerkingen

Important

De Exchange<T>(T, T) methode overbelasting biedt een algemeen alternatief dat kan worden gebruikt voor concrete referentietypen.

Zie ook

Het Beheerd Draadbeheer
Overzicht van synchronisatie primitiefen

Van toepassing op

Exchange(IntPtr, IntPtr)

Hiermee stelt u een geheel getal met een eigen grootte in op een opgegeven waarde en retourneert u de oorspronkelijke waarde als atomische bewerking.

public:
 static IntPtr Exchange(IntPtr % location1, IntPtr value);

public static IntPtr Exchange(ref IntPtr location1, IntPtr value);

static member Exchange : nativeint * nativeint -> nativeint

Public Shared Function Exchange (ByRef location1 As IntPtr, value As IntPtr) As IntPtr

Parameters

location1: IntPtr
nativeint

De variabele die moet worden ingesteld op de opgegeven waarde.

value: IntPtr
nativeint

De waarde waarop de location1 parameter is ingesteld.

Retouren

IntPtr

nativeint

De oorspronkelijke waarde van location1.

Uitzonderingen

NullReferenceException

Het adres van location1 is een null aanwijzer.

Zie ook

Het Beheerd Draadbeheer
Overzicht van synchronisatie primitiefen

Van toepassing op

Exchange(Double, Double)

Stelt een drijvendekommagetal met dubbele precisie in op een opgegeven waarde en retourneert de oorspronkelijke waarde als een atomische bewerking.

public:
 static double Exchange(double % location1, double value);

public static double Exchange(ref double location1, double value);

static member Exchange : double * double -> double

Public Shared Function Exchange (ByRef location1 As Double, value As Double) As Double

Parameters

location1: Double

De variabele die moet worden ingesteld op de opgegeven waarde.

value: Double

De waarde waarop de location1 parameter is ingesteld.

Retouren

Double

De oorspronkelijke waarde van location1.

Uitzonderingen

NullReferenceException

Het adres van location1 is een null aanwijzer.

Zie ook

Het Beheerd Draadbeheer
Overzicht van synchronisatie primitiefen

Van toepassing op

Exchange(Int32, Int32)

Stelt een 32-bits ondertekend geheel getal in op een opgegeven waarde en retourneert de oorspronkelijke waarde als een atomische bewerking.

public:
 static int Exchange(int % location1, int value);

public static int Exchange(ref int location1, int value);

static member Exchange : int * int -> int

Public Shared Function Exchange (ByRef location1 As Integer, value As Integer) As Integer

Parameters

location1: Int32

De variabele die moet worden ingesteld op de opgegeven waarde.

value: Int32

De waarde waarop de location1 parameter is ingesteld.

Retouren

Int32

De oorspronkelijke waarde van location1.

Uitzonderingen

ArgumentNullException

Het adres van location1 is een null aanwijzer.

NullReferenceException

Het adres van location1 is een null aanwijzer.

Voorbeelden

In het volgende codevoorbeeld ziet u een thread-veilig mechanisme voor het vergrendelen van resources.

using System;
using System.Threading;

namespace InterlockedExchange_Example
{
    class MyInterlockedExchangeExampleClass
    {
        //0 for false, 1 for true.
        private static int usingResource = 0;

        private const int numThreadIterations = 5;
        private const int numThreads = 10;

        static void Main()
        {
            Thread myThread;
            Random rnd = new Random();

            for(int i = 0; i < numThreads; i++)
            {
                myThread = new Thread(new ThreadStart(MyThreadProc));
                myThread.Name = String.Format("Thread{0}", i + 1);
            
                //Wait a random amount of time before starting next thread.
                Thread.Sleep(rnd.Next(0, 1000));
                myThread.Start();
            }
        }

        private static void MyThreadProc()
        {
            for(int i = 0; i < numThreadIterations; i++)
            {
                UseResource();
            
                //Wait 1 second before next attempt.
                Thread.Sleep(1000);
            }
        }

        //A simple method that denies reentrancy.
        static bool UseResource()
        {
            //0 indicates that the method is not in use.
            if(0 == Interlocked.Exchange(ref usingResource, 1))
            {
                Console.WriteLine("{0} acquired the lock", Thread.CurrentThread.Name);
            
                //Code to access a resource that is not thread safe would go here.
            
                //Simulate some work
                Thread.Sleep(500);

                Console.WriteLine("{0} exiting lock", Thread.CurrentThread.Name);
            
                //Release the lock
                Interlocked.Exchange(ref usingResource, 0);
                return true;
            }
            else
            {
                Console.WriteLine("   {0} was denied the lock", Thread.CurrentThread.Name);
                return false;
            }
        }
    }
}

Imports System.Threading

Namespace InterlockedExchange_Example
    Class MyInterlockedExchangeExampleClass
        '0 for false, 1 for true.
        Private Shared usingResource As Integer = 0

        Private Const numThreadIterations As Integer = 5
        Private Const numThreads As Integer = 10

        <MTAThread> _
        Shared Sub Main()
            Dim myThread As Thread
            Dim rnd As New Random()

            Dim i As Integer
            For i = 0 To numThreads - 1
                myThread = New Thread(AddressOf MyThreadProc)
                myThread.Name = String.Format("Thread{0}", i + 1)

                'Wait a random amount of time before starting next thread.
                Thread.Sleep(rnd.Next(0, 1000))
                myThread.Start()
            Next i
        End Sub

        Private Shared Sub MyThreadProc()
            Dim i As Integer
            For i = 0 To numThreadIterations - 1
                UseResource()

                'Wait 1 second before next attempt.
                Thread.Sleep(1000)
            Next i
        End Sub 

        'A simple method that denies reentrancy.
        Shared Function UseResource() As Boolean
            '0 indicates that the method is not in use.
            If 0 = Interlocked.Exchange(usingResource, 1) Then
                Console.WriteLine("{0} acquired the lock", Thread.CurrentThread.Name)

                'Code to access a resource that is not thread safe would go here.
                'Simulate some work
                Thread.Sleep(500)

                Console.WriteLine("{0} exiting lock", Thread.CurrentThread.Name)

                'Release the lock
                Interlocked.Exchange(usingResource, 0)
                Return True
            Else
                Console.WriteLine("   {0} was denied the lock", Thread.CurrentThread.Name)
                Return False
            End If
        End Function 
    End Class 
End Namespace

Zie ook

Het Beheerd Draadbeheer
Overzicht van synchronisatie primitiefen

Van toepassing op

Exchange(Int64, Int64)

Stelt een 64-bits ondertekend geheel getal in op een opgegeven waarde en retourneert de oorspronkelijke waarde als een atomische bewerking.

public:
 static long Exchange(long % location1, long value);

public static long Exchange(ref long location1, long value);

static member Exchange : int64 * int64 -> int64

Public Shared Function Exchange (ByRef location1 As Long, value As Long) As Long

Parameters

location1: Int64

De variabele die moet worden ingesteld op de opgegeven waarde.

value: Int64

De waarde waarop de location1 parameter is ingesteld.

Retouren

Int64

De oorspronkelijke waarde van location1.

Uitzonderingen

NullReferenceException

Het adres van location1 is een null aanwijzer.

Zie ook

Het Beheerd Draadbeheer
Overzicht van synchronisatie primitiefen

Van toepassing op

Exchange<T>(T, T)

Stelt een variabele van het opgegeven type T in op een opgegeven waarde en retourneert de oorspronkelijke waarde als atomische bewerking.

public:
generic <typename T>
 where T : class static T Exchange(T % location1, T value);

public static T Exchange<T>(ref T location1, T value) where T : class;

[System.Runtime.InteropServices.ComVisible(false)]
public static T Exchange<T>(ref T location1, T value) where T : class;

static member Exchange : 'T * 'T -> 'T (requires 'T : null)

[<System.Runtime.InteropServices.ComVisible(false)>]
static member Exchange : 'T * 'T -> 'T (requires 'T : null)

Public Shared Function Exchange(Of T As Class) (ByRef location1 As T, value As T) As T

Type parameters

T

Het type dat moet worden gebruikt voor location1 en value.

Parameters

location1: T

De variabele die moet worden ingesteld op de opgegeven waarde. Dit is een referentieparameter (ref in C#, ByRef in Visual Basic).

value: T

De waarde waarop de location1 parameter is ingesteld.

Retouren

De oorspronkelijke waarde van location1.

Kenmerken: ComVisibleAttribute

Uitzonderingen

NullReferenceException

Het adres van location1 is een null aanwijzer.

NotSupportedException

Er wordt een niet-ondersteund T . In .NET 8 en eerdere versies moet T een verwijzingstype zijn. In .NET 9 en latere versies moet T een verwijzing, primitief of opsommingstype zijn.

Van toepassing op

Feedback

Is deze pagina nuttig?