Message.TimeToBeReceived Eigenschaft

Referenz

Definition

Namespace:: System.Messaging

Assembly:: System.Messaging.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die Zeitbegrenzung für den Empfang der Meldung aus der Zielwarteschlange ab oder legt diese fest.

public:
 property TimeSpan TimeToBeReceived { TimeSpan get(); void set(TimeSpan value); };

[System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))]
[System.Messaging.MessagingDescription("MsgTimeToBeReceived")]
public TimeSpan TimeToBeReceived { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))>]
[<System.Messaging.MessagingDescription("MsgTimeToBeReceived")>]
member this.TimeToBeReceived : TimeSpan with get, set

Public Property TimeToBeReceived As TimeSpan

Eigenschaftswert

TimeSpan

Die für eine gesendete Meldung vorgegebene Gesamtzeit bis zum Empfang aus der Zielwarteschlange. Der Standardwert ist InfiniteTimeout.

Attribute: TypeConverterAttribute MessagingDescriptionAttribute

Ausnahmen

InvalidOperationException

Die TimeToBeReceived-Eigenschaft wird aufgrund eines für die Meldungswarteschlange gesetzten Filters ignoriert.

ArgumentException

Der für TimeToBeReceived angegebene Wert ist ungültig.

Beispiele

Im folgenden Codebeispiel wird der Wert der Eigenschaft einer Nachricht TimeToBeReceived abgerufen und festgelegt.

Hinweise

Die TimeToBeReceived -Eigenschaft gibt die Gesamtzeit für eine gesendete Nachricht an, die von der Zielwarteschlange empfangen werden soll. Das Zeitlimit umfasst die Zeit, die für den Zugriff auf die Zielwarteschlange aufgewendet wird, und die Wartezeit in der Warteschlange, bevor die Nachricht empfangen wird.

Achtung

Stellen Sie bei Verwendung abhängiger Clientcomputer sicher, dass die Uhr auf dem Clientcomputer mit der Uhr auf dem Server synchronisiert ist, auf dem Message Queuing ausgeführt wird. Andernfalls kann beim Senden einer Nachricht, deren TimeToBeReceived Eigenschaft nicht InfiniteTimeoutist, unvorhersehbares Verhalten auftreten.

Wenn das durch die TimeToBeReceived -Eigenschaft angegebene Intervall abläuft, bevor die Nachricht aus der Warteschlange entfernt wird, verwirft Message Queuing die Nachricht auf eine von zwei Arten. Wenn die UseDeadLetterQueue-Eigenschaft auf true festgelegt ist, wird die Nachricht an die Dead Letter-Warteschlange gesendet. Wenn UseDeadLetterQueue ist false, wird die Nachricht ignoriert.

Sie können die Eigenschaft der Nachricht so festlegen, dass Message Queuing eine negative Bestätigungsnachricht AcknowledgeType zurück an die sendende Anwendung sendet, wenn die Nachricht nicht abgerufen wird, bevor der Timer abläuft.

Wenn der durch die TimeToBeReceived -Eigenschaft angegebene Wert kleiner als der von der TimeToReachQueue -Eigenschaft angegebene Wert ist, TimeToBeReceived hat Vorrang.

Wenn mehrere Nachrichten in einer einzelnen Transaktion gesendet werden, verwendet Message Queuing die TimeToBeReceived Eigenschaft der ersten Nachricht.

Gilt für:

Freigeben über