Interlocked.Exchange メソッド

定義

名前空間:: System.Threading

アセンブリ:: netstandard.dll, System.Threading.dll

アセンブリ:: mscorlib.dll, System.Threading.dll

アセンブリ:: System.Threading.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

変数をアトミック操作として指定した値に設定します。

オーバーロード

名前	説明
Exchange(UInt16, UInt16)	16 ビット符号付き整数を指定した値に設定し、元の値をアトミック操作として返します。
Exchange(UInt32, UInt32)	32 ビット符号なし整数を指定した値に設定し、元の値をアトミック操作として返します。
Exchange(Single, Single)	単精度浮動小数点数を指定した値に設定し、アトミック演算として元の値を返します。
Exchange(UIntPtr, UIntPtr)	ネイティブサイズの符号なし整数を指定した値に設定し、元の値をアトミック操作として返します。
Exchange(UInt64, UInt64)	64 ビット符号なし整数を指定した値に設定し、元の値をアトミック操作として返します。
Exchange(SByte, SByte)	8 ビット符号付き整数を指定した値に設定し、元の値をアトミック操作として返します。
Exchange(Byte, Byte)	8 ビット符号なし整数を指定した値に設定し、元の値をアトミック操作として返します。
Exchange(IntPtr, IntPtr)	ネイティブサイズの符号付き整数を指定した値に設定し、元の値をアトミック操作として返します。
Exchange(Int64, Int64)	64 ビット符号付き整数を指定した値に設定し、元の値をアトミック操作として返します。
Exchange(Int32, Int32)	32 ビット符号付き整数を指定した値に設定し、元の値をアトミック操作として返します。
Exchange(Int16, Int16)	16 ビット符号なし整数を指定した値に設定し、元の値をアトミック操作として返します。
Exchange(Double, Double)	倍精度浮動小数点数を指定した値に設定し、元の値をアトミック演算として返します。
Exchange(Object, Object)	オブジェクトを指定した値に設定し、元のオブジェクトへの参照をアトミック操作として返します。
Exchange<T>(T, T)	指定した型 `T` の変数を指定した値に設定し、元の値をアトミック操作として返します。

Exchange(UInt16, UInt16)

ソース:: Interlocked.cs

ソース:: Interlocked.cs

重要

この API は CLS 準拠ではありません。

16 ビット符号付き整数を指定した値に設定し、元の値をアトミック操作として返します。

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 -> uint16

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

パラメーター

location1: UInt16

指定した値に設定する変数。

value: UInt16

location1 パラメーターの設定先の値。

返品

UInt16

location1の元の値。

属性: CLSCompliantAttribute

例外

NullReferenceException

location1 のアドレスは、null ポインターです。

適用対象

Exchange(UInt32, UInt32)

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

重要

この API は CLS 準拠ではありません。

32 ビット符号なし整数を指定した値に設定し、元の値をアトミック操作として返します。

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 -> uint32

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

パラメーター

location1: UInt32

指定した値に設定する変数。

value: UInt32

location1 パラメーターの設定先の値。

返品

UInt32

location1の元の値。

属性: CLSCompliantAttribute

例外

NullReferenceException

location1 のアドレスは、null ポインターです。

適用対象

Exchange(Single, Single)

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

単精度浮動小数点数を指定した値に設定し、アトミック演算として元の値を返します。

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

パラメーター

location1: Single

指定した値に設定する変数。

value: Single

location1 パラメーターの設定先の値。

返品

Single

location1の元の値。

例外

NullReferenceException

location1 のアドレスは、null ポインターです。

こちらもご覧ください

マネージドスレッドの
同期プリミティブの概要

適用対象

Exchange(UIntPtr, UIntPtr)

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

重要

この API は CLS 準拠ではありません。

ネイティブサイズの符号なし整数を指定した値に設定し、元の値をアトミック操作として返します。

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 -> unativeint

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

パラメーター

location1: UIntPtr
unativeint

指定した値に設定する変数。

value: UIntPtr
unativeint

location1 パラメーターの設定先の値。

返品

UIntPtr

unativeint

location1の元の値。

属性: CLSCompliantAttribute

例外

NullReferenceException

location1 のアドレスは、null ポインターです。

適用対象

Exchange(UInt64, UInt64)

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

重要

この API は CLS 準拠ではありません。

64 ビット符号なし整数を指定した値に設定し、元の値をアトミック操作として返します。

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 -> uint64

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

パラメーター

location1: UInt64

指定した値に設定する変数。

value: UInt64

location1 パラメーターの設定先の値。

返品

UInt64

location1の元の値。

属性: CLSCompliantAttribute

例外

NullReferenceException

location1 のアドレスは、null ポインターです。

適用対象

Exchange(SByte, SByte)

ソース:: Interlocked.cs

ソース:: Interlocked.cs

重要

この API は CLS 準拠ではありません。

8 ビット符号付き整数を指定した値に設定し、元の値をアトミック操作として返します。

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 -> sbyte

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

パラメーター

location1: SByte

指定した値に設定する変数。

value: SByte

location1 パラメーターの設定先の値。

返品

SByte

location1の元の値。

属性: CLSCompliantAttribute

例外

NullReferenceException

location1 のアドレスは、null ポインターです。

適用対象

Exchange(Byte, Byte)

ソース:: Interlocked.cs

ソース:: Interlocked.cs

8 ビット符号なし整数を指定した値に設定し、元の値をアトミック操作として返します。

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 -> byte

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

パラメーター

location1: Byte

指定した値に設定する変数。

value: Byte

location1 パラメーターの設定先の値。

返品

Byte

location1の元の値。

例外

NullReferenceException

location1 のアドレスは、null ポインターです。

適用対象

Exchange(IntPtr, IntPtr)

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ネイティブサイズの符号付き整数を指定した値に設定し、元の値をアトミック操作として返します。

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

パラメーター

location1: IntPtr
nativeint

指定した値に設定する変数。

value: IntPtr
nativeint

location1 パラメーターの設定先の値。

返品

IntPtr

nativeint

location1の元の値。

例外

NullReferenceException

location1 のアドレスは、null ポインターです。

こちらもご覧ください

マネージドスレッドの
同期プリミティブの概要

適用対象

Exchange(Int64, Int64)

ソース:: Interlocked.CoreCLR.cs

ソース:: Interlocked.CoreCLR.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.CoreCLR.cs

64 ビット符号付き整数を指定した値に設定し、元の値をアトミック操作として返します。

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

パラメーター

location1: Int64

指定した値に設定する変数。

value: Int64

location1 パラメーターの設定先の値。

返品

Int64

location1の元の値。

例外

NullReferenceException

location1 のアドレスは、null ポインターです。

こちらもご覧ください

マネージドスレッドの
同期プリミティブの概要

適用対象

Exchange(Int32, Int32)

ソース:: Interlocked.CoreCLR.cs

ソース:: Interlocked.CoreCLR.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.CoreCLR.cs

32 ビット符号付き整数を指定した値に設定し、元の値をアトミック操作として返します。

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

パラメーター

location1: Int32

指定した値に設定する変数。

value: Int32

location1 パラメーターの設定先の値。

返品

Int32

location1の元の値。

例外

ArgumentNullException

location1 のアドレスは、null ポインターです。

NullReferenceException

location1 のアドレスは、null ポインターです。

例

次のコード例は、スレッドセーフなリソースロックメカニズムを示しています。

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

こちらもご覧ください

マネージドスレッドの
同期プリミティブの概要

適用対象

Exchange(Int16, Int16)

ソース:: Interlocked.cs

ソース:: Interlocked.cs

16 ビット符号なし整数を指定した値に設定し、元の値をアトミック操作として返します。

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

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

static member Exchange : int16 * int16 -> int16

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

パラメーター

location1: Int16

指定した値に設定する変数。

value: Int16

location1 パラメーターの設定先の値。

返品

Int16

location1の元の値。

例外

NullReferenceException

location1 のアドレスは、null ポインターです。

適用対象

Exchange(Double, Double)

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

倍精度浮動小数点数を指定した値に設定し、元の値をアトミック演算として返します。

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

パラメーター

location1: Double

指定した値に設定する変数。

value: Double

location1 パラメーターの設定先の値。

返品

Double

location1の元の値。

例外

NullReferenceException

location1 のアドレスは、null ポインターです。

こちらもご覧ください

マネージドスレッドの
同期プリミティブの概要

適用対象

Exchange(Object, Object)

ソース:: Interlocked.CoreCLR.cs

ソース:: Interlocked.CoreCLR.cs

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.CoreCLR.cs

オブジェクトを指定した値に設定し、元のオブジェクトへの参照をアトミック操作として返します。

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 -> obj

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

パラメーター

location1: Object

指定した値に設定する変数。

value: Object

location1 パラメーターの設定先の値。

返品

Object

location1の元の値。

例外

ArgumentNullException

location1 のアドレスは、null ポインターです。

NullReferenceException

location1 のアドレスは、null ポインターです。

注釈

大事な

Exchange<T>(T, T) メソッドのオーバーロードは、具象参照型に使用できる一般的な代替手段を提供します。

こちらもご覧ください

マネージドスレッドの
同期プリミティブの概要

適用対象

Exchange<T>(T, T)

ソース:: Interlocked.cs

ソース:: Interlocked.cs

ソース:: Interlocked.CoreCLR.cs

ソース:: Interlocked.CoreCLR.cs

ソース:: Interlocked.CoreCLR.cs

指定した型 T の変数を指定した値に設定し、元の値をアトミック操作として返します。

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 T

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

型パラメーター

T

location1 および valueに使用する型。

パラメーター

location1: T

指定した値に設定する変数。これは参照パラメーターです (C# ではref、Visual Basic では ByRef)。

value: T

location1 パラメーターの設定先の値。

返品

location1の元の値。

属性: ComVisibleAttribute

例外

NullReferenceException

location1 のアドレスは、null ポインターです。

NotSupportedException

サポートされていない T が指定されています。 .NET 8 以前のバージョンでは、T は参照型である必要があります。 .NET 9 以降のバージョンでは、T は参照型、プリミティブ型、または列挙型である必要があります。

適用対象

フィードバック

このページはお役に立ちましたか?