Message.UseDeadLetterQueue 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 einen Wert ab, der angibt, ob eine Kopie der nicht zustellbaren Meldung an eine Dead Letter-Warteschlange gesendet werden soll, oder legt diesen fest.

public:
 property bool UseDeadLetterQueue { bool get(); void set(bool value); };

[System.Messaging.MessagingDescription("MsgUseDeadLetterQueue")]
public bool UseDeadLetterQueue { get; set; }

[<System.Messaging.MessagingDescription("MsgUseDeadLetterQueue")>]
member this.UseDeadLetterQueue : bool with get, set

Public Property UseDeadLetterQueue As Boolean

Eigenschaftswert

Boolean

true, wenn bei einem Fehler bei der Meldungsübermittlung eine Kopie der Meldung an die Warteschlange für unzustellbare Nachrichten gesendet werden soll, andernfalls false. Der Standardwert ist false.

Attribute: MessagingDescriptionAttribute

Ausnahmen

InvalidOperationException

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

Beispiele

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

Hinweise

Die UseJournalQueue Eigenschaften und UseDeadLetterQueue geben an, wie Message Queuing eine Nachricht nachverfolgt. Wenn UseDeadLetterQueue ist, bewirkt trueein Übermittlungsfehler (einer nicht transaktionalen Nachricht), dass die Nachricht an die nicht transaktionale Warteschlange für unzustellbare Nachrichten auf dem Computer gesendet wird, der die Nachricht nicht übermitteln konnte. Ein Übermittlungsfehler kann z. B. dadurch verursacht werden, dass ein Nachrichtentimer abläuft.

Im Falle eines Übermittlungsfehlers für eine Transaktionsnachricht sendet Message Queuing die Nachricht in allen negativen und zweifelsfreien Fällen an die Transaktionswarteschlange für unzustellbare Nachrichten auf dem Quellcomputer.

Wenn Sie Nachrichten in einer Warteschlange für unzustellbare Nachrichten speichern, sollten Sie die Warteschlange regelmäßig löschen, um nicht mehr benötigte Nachrichten zu entfernen. Nachrichten, die in Warteschlangen für unzustellbare Nachrichten gespeichert sind, zählen auf das Größenkontingent für den Computer, auf dem sich die Warteschlange befindet. Das Computerkontingent wird vom Administrator festgelegt und bezieht sich auf die Größe, die zum Speichern von Nachrichten auf dem gesamten Computer zugewiesen ist, nicht nur in einer einzelnen Warteschlange.

Sie erstellen keine Journal- oder Unzustellbare Warteschlange. Dies sind beide Systemwarteschlangen, die von Message Queuing generiert werden.

Gilt für: