Interlocked.Exchange Methode
Definitie
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(UInt16, UInt16) |
Stelt een 16-bits ondertekend geheel getal in op een opgegeven waarde en retourneert de oorspronkelijke waarde als een atomische bewerking. |
| Exchange(UInt32, UInt32) |
Stelt een 32-bits geheel getal zonder teken in op een opgegeven waarde en retourneert de oorspronkelijke waarde als een 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. |
| Exchange(UIntPtr, UIntPtr) |
Hiermee stelt u een geheel getal met een systeemeigen grootte in op een opgegeven waarde en wordt de oorspronkelijke waarde geretourneerd als een atomische bewerking. |
| Exchange(UInt64, UInt64) |
Stelt een 64-bits geheel getal zonder teken in op een opgegeven waarde en retourneert de oorspronkelijke waarde als een atomische bewerking. |
| Exchange(SByte, SByte) |
Stelt een 8-bits ondertekend geheel getal in op een opgegeven waarde en retourneert de oorspronkelijke waarde als een atomische bewerking. |
| Exchange(Byte, Byte) |
Stelt een 8-bits geheel getal zonder teken in op een opgegeven waarde en retourneert de oorspronkelijke waarde als een 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(Int64, Int64) |
Stelt een 64-bits ondertekend geheel getal 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(Int16, Int16) |
Stelt een 16-bits geheel getal zonder teken in op een opgegeven waarde en retourneert de oorspronkelijke waarde als een 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(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<T>(T, T) |
Stelt een variabele van het opgegeven type |
Exchange(UInt16, UInt16)
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
Belangrijk
Deze API is niet CLS-conform.
Stelt een 16-bits ondertekend geheel getal in op een opgegeven waarde en retourneert de oorspronkelijke waarde als een atomische bewerking.
public:
static System::UInt16 Exchange(System::UInt16 % location1, System::UInt16 value);[System.CLSCompliant(false)]
public static ushort Exchange(ref ushort location1, ushort value);[<System.CLSCompliant(false)>]
static member Exchange : uint16 * uint16 -> uint16Public Shared Function Exchange (ByRef location1 As UShort, value As UShort) As UShortParameters
- location1
- UInt16
De variabele die moet worden ingesteld op de opgegeven waarde.
- value
- UInt16
De waarde waarop de location1 parameter is ingesteld.
Retouren
De oorspronkelijke waarde van location1.
- Kenmerken
Uitzonderingen
Het adres van locatie1 is een null aanwijzer.
Van toepassing op
Exchange(UInt32, UInt32)
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
Belangrijk
Deze API is niet CLS-conform.
Stelt een 32-bits geheel getal zonder teken in op een opgegeven waarde en retourneert de oorspronkelijke waarde als een atomische bewerking.
public:
static System::UInt32 Exchange(System::UInt32 % location1, System::UInt32 value);[System.CLSCompliant(false)]
public static uint Exchange(ref uint location1, uint value);[<System.CLSCompliant(false)>]
static member Exchange : uint32 * uint32 -> uint32Public Shared Function Exchange (ByRef location1 As UInteger, value As UInteger) As UIntegerParameters
- location1
- UInt32
De variabele die moet worden ingesteld op de opgegeven waarde.
- value
- UInt32
De waarde waarop de location1 parameter is ingesteld.
Retouren
De oorspronkelijke waarde van location1.
- Kenmerken
Uitzonderingen
Het adres van location1 is een null aanwijzer.
Van toepassing op
Exchange(Single, Single)
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
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 -> singlePublic Shared Function Exchange (ByRef location1 As Single, value As Single) As SingleParameters
- location1
- Single
De variabele die moet worden ingesteld op de opgegeven waarde.
- value
- Single
De waarde waarop de location1 parameter is ingesteld.
Retouren
De oorspronkelijke waarde van location1.
Uitzonderingen
Het adres van location1 is een null aanwijzer.
Zie ook
- Het Beheerd Draadbeheer
- Overzicht van synchronisatie primitiefen
Van toepassing op
Exchange(UIntPtr, UIntPtr)
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
Belangrijk
Deze API is niet CLS-conform.
Hiermee stelt u een geheel getal met een systeemeigen grootte in op een opgegeven waarde en wordt de oorspronkelijke waarde geretourneerd als een atomische bewerking.
public:
static UIntPtr Exchange(UIntPtr % location1, UIntPtr value);[System.CLSCompliant(false)]
public static UIntPtr Exchange(ref UIntPtr location1, UIntPtr value);[<System.CLSCompliant(false)>]
static member Exchange : unativeint * unativeint -> unativeintPublic Shared Function Exchange (ByRef location1 As UIntPtr, value As UIntPtr) As UIntPtrParameters
- location1
-
UIntPtr
unativeint
De variabele die moet worden ingesteld op de opgegeven waarde.
- value
-
UIntPtr
unativeint
De waarde waarop de location1 parameter is ingesteld.
Retouren
unativeint
De oorspronkelijke waarde van location1.
- Kenmerken
Uitzonderingen
Het adres van location1 is een null aanwijzer.
Van toepassing op
Exchange(UInt64, UInt64)
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
Belangrijk
Deze API is niet CLS-conform.
Stelt een 64-bits geheel getal zonder teken in op een opgegeven waarde en retourneert de oorspronkelijke waarde als een atomische bewerking.
public:
static System::UInt64 Exchange(System::UInt64 % location1, System::UInt64 value);[System.CLSCompliant(false)]
public static ulong Exchange(ref ulong location1, ulong value);[<System.CLSCompliant(false)>]
static member Exchange : uint64 * uint64 -> uint64Public Shared Function Exchange (ByRef location1 As ULong, value As ULong) As ULongParameters
- location1
- UInt64
De variabele die moet worden ingesteld op de opgegeven waarde.
- value
- UInt64
De waarde waarop de location1 parameter is ingesteld.
Retouren
De oorspronkelijke waarde van location1.
- Kenmerken
Uitzonderingen
Het adres van location1 is een null aanwijzer.
Van toepassing op
Exchange(SByte, SByte)
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
Belangrijk
Deze API is niet CLS-conform.
Stelt een 8-bits ondertekend geheel getal in op een opgegeven waarde en retourneert de oorspronkelijke waarde als een atomische bewerking.
public:
static System::SByte Exchange(System::SByte % location1, System::SByte value);[System.CLSCompliant(false)]
public static sbyte Exchange(ref sbyte location1, sbyte value);[<System.CLSCompliant(false)>]
static member Exchange : sbyte * sbyte -> sbytePublic Shared Function Exchange (ByRef location1 As SByte, value As SByte) As SByteParameters
- location1
- SByte
De variabele die moet worden ingesteld op de opgegeven waarde.
- value
- SByte
De waarde waarop de location1 parameter is ingesteld.
Retouren
De oorspronkelijke waarde van location1.
- Kenmerken
Uitzonderingen
Het adres van locatie1 is een null aanwijzer.
Van toepassing op
Exchange(Byte, Byte)
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
Stelt een 8-bits geheel getal zonder teken in op een opgegeven waarde en retourneert de oorspronkelijke waarde als een atomische bewerking.
public:
static System::Byte Exchange(System::Byte % location1, System::Byte value);public static byte Exchange(ref byte location1, byte value);static member Exchange : byte * byte -> bytePublic Shared Function Exchange (ByRef location1 As Byte, value As Byte) As ByteParameters
- location1
- Byte
De variabele die moet worden ingesteld op de opgegeven waarde.
- value
- Byte
De waarde waarop de location1 parameter is ingesteld.
Retouren
De oorspronkelijke waarde van location1.
Uitzonderingen
Het adres van locatie1 is een null aanwijzer.
Van toepassing op
Exchange(IntPtr, IntPtr)
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
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 -> nativeintPublic Shared Function Exchange (ByRef location1 As IntPtr, value As IntPtr) As IntPtrParameters
- 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
nativeint
De oorspronkelijke waarde van location1.
Uitzonderingen
Het adres van location1 is een null aanwijzer.
Zie ook
- Het Beheerd Draadbeheer
- Overzicht van synchronisatie primitiefen
Van toepassing op
Exchange(Int64, Int64)
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
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 -> int64Public Shared Function Exchange (ByRef location1 As Long, value As Long) As LongParameters
- location1
- Int64
De variabele die moet worden ingesteld op de opgegeven waarde.
- value
- Int64
De waarde waarop de location1 parameter is ingesteld.
Retouren
De oorspronkelijke waarde van location1.
Uitzonderingen
Het adres van location1 is een null aanwijzer.
Zie ook
- Het Beheerd Draadbeheer
- Overzicht van synchronisatie primitiefen
Van toepassing op
Exchange(Int32, Int32)
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
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 -> intPublic Shared Function Exchange (ByRef location1 As Integer, value As Integer) As IntegerParameters
- location1
- Int32
De variabele die moet worden ingesteld op de opgegeven waarde.
- value
- Int32
De waarde waarop de location1 parameter is ingesteld.
Retouren
De oorspronkelijke waarde van location1.
Uitzonderingen
Het adres van location1 is een null aanwijzer.
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(Int16, Int16)
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
Stelt een 16-bits geheel getal zonder teken in op een opgegeven waarde en retourneert de oorspronkelijke waarde als een atomische bewerking.
public:
static short Exchange(short % location1, short value);public static short Exchange(ref short location1, short value);static member Exchange : int16 * int16 -> int16Public Shared Function Exchange (ByRef location1 As Short, value As Short) As ShortParameters
- location1
- Int16
De variabele die moet worden ingesteld op de opgegeven waarde.
- value
- Int16
De waarde waarop de location1 parameter is ingesteld.
Retouren
De oorspronkelijke waarde van location1.
Uitzonderingen
Het adres van locatie1 is een null aanwijzer.
Van toepassing op
Exchange(Double, Double)
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
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 -> doublePublic Shared Function Exchange (ByRef location1 As Double, value As Double) As DoubleParameters
- location1
- Double
De variabele die moet worden ingesteld op de opgegeven waarde.
- value
- Double
De waarde waarop de location1 parameter is ingesteld.
Retouren
De oorspronkelijke waarde van location1.
Uitzonderingen
Het adres van location1 is een null aanwijzer.
Zie ook
- Het Beheerd Draadbeheer
- Overzicht van synchronisatie primitiefen
Van toepassing op
Exchange(Object, Object)
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
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);public static object? Exchange(ref object? location1, object? value);static member Exchange : obj * obj -> objPublic Shared Function Exchange (ByRef location1 As Object, value As Object) As ObjectParameters
- location1
- Object
De variabele die moet worden ingesteld op de opgegeven waarde.
- value
- Object
De waarde waarop de location1 parameter is ingesteld.
Retouren
De oorspronkelijke waarde van location1.
Uitzonderingen
Het adres van location1 is een null aanwijzer.
Het adres van location1 is een null aanwijzer.
Opmerkingen
Important
De overbelasting van de Exchange<T>(T, T) methode biedt een algemeen alternatief dat kan worden gebruikt voor concrete referentietypen.
Zie ook
- Het Beheerd Draadbeheer
- Overzicht van synchronisatie primitiefen
Van toepassing op
Exchange<T>(T, T)
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
- Bron:
- Interlocked.cs
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:
generic <typename T>
static T Exchange(T % location1, T value);public static T Exchange<T>(ref T location1, T value) where T : class;public static T Exchange<T>(ref T location1, T value);[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)static member Exchange : 'T * 'T -> 'T[<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 TPublic Shared Function Exchange(Of T) (ByRef location1 As T, value As T) As TType 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
Uitzonderingen
Het adres van location1 is een null aanwijzer.
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.
