Interlocked.Exchange 메서드

정의

네임스페이스:: System.Threading

어셈블리:: netstandard.dll, System.Threading.dll

어셈블리:: mscorlib.dll, System.Threading.dll

어셈블리:: System.Threading.dll

어셈블리:: mscorlib.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

변수를 지정된 값으로 원자성 연산으로 설정합니다.

오버로드

Name	Description
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)

Source:: Interlocked.cs

Source:: Interlocked.cs

Important

이 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)

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: Interlocked.cs

Important

이 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)

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: 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)

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: Interlocked.cs

Important

이 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)

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: Interlocked.cs

Important

이 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)

Source:: Interlocked.cs

Source:: Interlocked.cs

Important

이 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)

Source:: Interlocked.cs

Source:: 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)

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: 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)

Source:: Interlocked.CoreCLR.cs

Source:: Interlocked.CoreCLR.cs

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: 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)

Source:: Interlocked.CoreCLR.cs

Source:: Interlocked.CoreCLR.cs

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: 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)

Source:: Interlocked.cs

Source:: 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)

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: 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)

Source:: Interlocked.CoreCLR.cs

Source:: Interlocked.CoreCLR.cs

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: 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)

Source:: Interlocked.cs

Source:: Interlocked.cs

Source:: Interlocked.CoreCLR.cs

Source:: Interlocked.CoreCLR.cs

Source:: 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 참조, 기본 형식 또는 열거형 형식이어야 합니다.

적용 대상

피드백

이 페이지가 도움이 되었나요?