다음을 통해 공유


Message.TimeToReachQueue 속성

정의

메시지가 큐에 도달하기까지의 최대 시간을 가져오거나 설정합니다.

public:
 property TimeSpan TimeToReachQueue { TimeSpan get(); void set(TimeSpan value); };
[System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))]
[System.Messaging.MessagingDescription("MsgTimeToReachQueue")]
public TimeSpan TimeToReachQueue { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))>]
[<System.Messaging.MessagingDescription("MsgTimeToReachQueue")>]
member this.TimeToReachQueue : TimeSpan with get, set
Public Property TimeToReachQueue As TimeSpan

속성 값

메시지를 보낸 시간에서 해당 메시지가 대상 큐에 도달하기 까지의 제한 시간입니다. 기본값은 InfiniteTimeout입니다.

특성

예외

메시지 큐가 TimeToReachQueue 속성을 무시하도록 필터링된 경우

TimeToReachQueue에 지정된 값이 잘못되었습니다. (예: 음수가 지정된 경우)

예제

다음 코드 예제를 가져오고 메시지의 값을 설정 TimeToReachQueue 속성입니다.

설명

으로 지정한 간격이 하는 경우는 TimeToReachQueue 속성 만료 메시지 대상에 도달 하기 전에, 메시지 큐 두 가지 방법 중 하나에서 메시지를 삭제 합니다. 메시지의 UseDeadLetterQueue 속성이 true이면 배달 못 한 편지 큐로 메시지가 보내집니다. 하는 경우 UseDeadLetterQueuefalse, 메시지는 무시 됩니다.

메시지의 AcknowledgeType 속성을 설정하여 타이머가 만료되기 전에 메시지가 도착하지 않는 경우 메시지 큐에서 음성 승인 메시지를 보내는 애플리케이션으로 다시 보내도록 요청할 수 있습니다.

속성이 TimeToReachQueue 0초로 설정된 경우 메시지 큐는 메시지를 한 번 시도하여 메시지를 대상으로 보냅니다( 큐가 메시지를 기다리는 경우). 큐는 로컬 메시지를 항상 큐에 도달 합니다.

하 여 지정 된 값을 TimeToReachQueue 속성에 지정 된 값 보다 큽니다.는 TimeToBeReceived 속성을 TimeToBeReceived 우선적으로 적용 합니다.

단일 트랜잭션에서 여러 개의 메시지를 보내면 메시지 큐에서 사용 하 여 TimeToReachQueue 첫 번째 메시지의 속성입니다.

적용 대상

추가 정보