BlockingCollection<T>.TryAdd 메서드

정의

네임스페이스:

System.Collections.Concurrent

어셈블리:

System.Collections.Concurrent.dll

BlockingCollection<T>에 지정된 항목을 추가하려고 시도합니다.

오버로드

TryAdd(T, Int32)	지정된 시간 안에 지정된 항목을 BlockingCollection<T>에 추가하려고 시도합니다.
TryAdd(T, Int32, CancellationToken)	취소 토큰을 관찰하는 동안 지정된 시간 안에 지정된 항목을 BlockingCollection<T>에 추가하려고 시도합니다.
TryAdd(T)	BlockingCollection<T>에 지정된 항목을 추가하려고 시도합니다.
TryAdd(T, TimeSpan)	BlockingCollection<T>에 지정된 항목을 추가하려고 시도합니다.

TryAdd(T, Int32)

Source:

BlockingCollection.cs

지정된 시간 안에 지정된 항목을 BlockingCollection<T>에 추가하려고 시도합니다.

public:
 bool TryAdd(T item, int millisecondsTimeout);

public bool TryAdd (T item, int millisecondsTimeout);

member this.TryAdd : 'T * int -> bool

Public Function TryAdd (item As T, millisecondsTimeout As Integer) As Boolean

매개 변수

item

T

컬렉션에 추가될 항목입니다.

millisecondsTimeout

Int32

컬렉션이 항목을 수락할 때까지 대기할 시간(밀리초) 또는 Infinite (-1)이 무기한 대기하는 횟수입니다.

반환

Boolean

지정된 시간 안에 item을 컬렉션에 추가할 수 있으면 true이고, 그렇지 않으면 false입니다. 항목이 중복이고 기본 컬렉션에서 중복 항목을 받아들이지 않는 경우에는 InvalidOperationException이 throw됩니다.

예외

ObjectDisposedException

BlockingCollection<T>가 삭제된 경우

ArgumentOutOfRangeException

millisecondsTimeout이 시간 제한 없음을 나타내는 -1 이외의 음수인 경우

InvalidOperationException

BlockingCollection<T>는 추가 관련하여 완료된 것으로 표시되었습니다.

또는

기본 컬렉션에서 항목을 적용하지 않았습니다.

추가 정보

• 스레드로부터 안전한 컬렉션
• BlockingCollection 개요

TryAdd(T, Int32, CancellationToken)

Source:

BlockingCollection.cs

취소 토큰을 관찰하는 동안 지정된 시간 안에 지정된 항목을 BlockingCollection<T>에 추가하려고 시도합니다.

public:
 bool TryAdd(T item, int millisecondsTimeout, System::Threading::CancellationToken cancellationToken);

public bool TryAdd (T item, int millisecondsTimeout, System.Threading.CancellationToken cancellationToken);

member this.TryAdd : 'T * int * System.Threading.CancellationToken -> bool

Public Function TryAdd (item As T, millisecondsTimeout As Integer, cancellationToken As CancellationToken) As Boolean

매개 변수

item

T

컬렉션에 추가될 항목입니다.

millisecondsTimeout

Int32

컬렉션이 항목을 수락할 때까지 대기할 시간(밀리초) 또는 Infinite (-1)이 무기한 대기하는 횟수입니다.

cancellationToken

CancellationToken

관찰할 취소 토큰입니다.

반환

Boolean

지정된 시간 안에 item을 컬렉션에 추가할 수 있으면 true이고, 그렇지 않으면 false입니다. 항목이 중복이고 기본 컬렉션에서 중복 항목을 받아들이지 않는 경우에는 InvalidOperationException이 throw됩니다.

예외

OperationCanceledException

CancellationToken이 취소되었습니다.

ObjectDisposedException

BlockingCollection<T>이 삭제되었거나 내부 CancellationTokenSource가 삭제되었습니다.

ArgumentOutOfRangeException

millisecondsTimeout이 시간 제한 없음을 나타내는 -1 이외의 음수인 경우

InvalidOperationException

BlockingCollection<T>는 추가 관련하여 완료된 것으로 표시되었습니다.

또는

기본 컬렉션에서 항목을 적용하지 않았습니다.

추가 정보

• 스레드로부터 안전한 컬렉션
• BlockingCollection 개요

TryAdd(T)

Source:

BlockingCollection.cs

BlockingCollection<T>에 지정된 항목을 추가하려고 시도합니다.

public:
 bool TryAdd(T item);

public bool TryAdd (T item);

member this.TryAdd : 'T -> bool

Public Function TryAdd (item As T) As Boolean

매개 변수

item

T

컬렉션에 추가될 항목입니다.

반환

Boolean

item을 추가할 수 있는 경우 true이고, 그렇지 않으면 false입니다. 항목이 중복이고 기본 컬렉션에서 중복 항목을 받아들이지 않는 경우에는 InvalidOperationException이 throw됩니다.

예외

ObjectDisposedException

BlockingCollection<T>가 삭제된 경우

InvalidOperationException

BlockingCollection<T>는 추가 관련하여 완료된 것으로 표시되었습니다.

또는

기본 컬렉션에서 항목을 적용하지 않았습니다.

설명

컬렉션이 제한된 컬렉션이고 가득 차면 이 메서드는 항목을 추가하지 않고 즉시 false를 반환합니다.

추가 정보

• 스레드로부터 안전한 컬렉션
• BlockingCollection 개요

TryAdd(T, TimeSpan)

Source:

BlockingCollection.cs

BlockingCollection<T>에 지정된 항목을 추가하려고 시도합니다.

public:
 bool TryAdd(T item, TimeSpan timeout);

public bool TryAdd (T item, TimeSpan timeout);

member this.TryAdd : 'T * TimeSpan -> bool

Public Function TryAdd (item As T, timeout As TimeSpan) As Boolean

매개 변수

item

T

컬렉션에 추가될 항목입니다.

timeout

TimeSpan

대기할 시간(밀리초)을 나타내는 TimeSpan이거나, 무한 대기하도록 -1밀리초를 나타내는 TimeSpan입니다.

반환

Boolean

지정된 시간 범위 내에서 item을 컬렉션에 추가할 수 있으면 true이고, 그렇지 않으면 false입니다.

예외

ObjectDisposedException

BlockingCollection<T>가 삭제된 경우

ArgumentOutOfRangeException

timeout 는 무한 제한 시간을 나타내는 -1밀리초 이외의 음수입니다.

또는

timeout 가 Int32.MaxValue보다 큽 수 있습니다.

InvalidOperationException

BlockingCollection<T>는 추가 관련하여 완료된 것으로 표시되었습니다.

또는

기본 컬렉션에서 항목을 적용하지 않았습니다.

추가 정보

• 스레드로부터 안전한 컬렉션
• BlockingCollection 개요