MessageQueueTransaction Klasse

Definition

Namespace:
System.Messaging
Assembly:
System.Messaging.dll

Stellt eine interne Message Queuing-Transaktion bereit.

public ref class MessageQueueTransaction : IDisposable
public class MessageQueueTransaction : IDisposable
type MessageQueueTransaction = class
    interface IDisposable
Public Class MessageQueueTransaction
Implements IDisposable
Vererbung
Object
MessageQueueTransaction
Implementiert
IDisposable

Hinweise

Zum Senden oder Empfangen einer Nachricht als Teil einer Transaktion können Sie die MessageQueueTransaction Klasse verwenden, um eine Transaktion zu erstellen und an eine Überladung der MessageQueue.Send Methode oder an die Methode zu übergeben, die MessageQueue.Receive einen transaction Parameter verwendet. Nachrichten, die als Teil einer Transaktion gesendet werden, müssen an Transaktionswarteschlangen gesendet werden. Nachrichten, die von Transaktionswarteschlangen empfangen werden, müssen mit einer angegebenen Transaktion empfangen werden.

Zusätzlich zur Receive Methode können Sie Nachrichten mit einem angegebenen Bezeichner oder einem angegebenen Korrelationsbezeichner empfangen. Weitere Informationen zum selektiven Empfangen von Nachrichten aus Transaktionswarteschlangen finden Sie unter den ReceiveById Methoden und ReceiveByCorrelationId Methoden.

Nachrichten, die an Transaktionswarteschlangen gesendet werden, werden entfernt, wenn die Transaktion zugesichert wird. Ebenso werden nachrichten, die von Transaktionswarteschlangen empfangen werden, an die Warteschlange zurückgegeben, wenn die Transaktion zurückgesetzt wird.

Wenn Sie ein Element MessageQueueTransaction instanziieren und an eine anwendbare Überladung der Send Methode oder Receive Methode übergeben, um eine Nachricht an eine nicht transaktionsbezogene Warteschlange zu senden oder eine Nachricht aus einer nicht transaktionsbezogenen Warteschlange zu empfangen, löst die Methode eine Ausnahme aus, die auf "Falsche Transaktionsverwendung" hinweist.

MessageQueueTransaction ist threading apartment aware, also if your apartment state is STA, you cannot use the transaction in multiple threads. Visual Basic legt den Status des Hauptthreads auf STAfest, sodass Sie die MTAThreadAttribute In-Unterroutine Main anwenden müssen. Andernfalls löst das Senden einer Transaktionsnachricht mit einem anderen Thread eine MessageQueueException Ausnahme aus. Sie wenden das MTAThreadAttribute folgende Fragment an.

<System.MTAThreadAttribute>
 public sub Main()

Konstruktoren

Name Beschreibung
MessageQueueTransaction()

Initialisiert eine neue Instanz der MessageQueueTransaction-Klasse.

Eigenschaften

Name Beschreibung
Status

Ruft den Status der Transaktion ab.

Methoden

Name Beschreibung
Abort()

Rollback der ausstehenden internen Transaktion.
Begin()

Startet eine neue interne Message Queuing-Transaktion.
Commit()

Führt einen Commit für eine ausstehende interne Transaktion durch.
Dispose()

Veröffentlicht alle ressourcen, die von der MessageQueueTransaction.
Dispose(Boolean)

Gibt die nicht verwalteten Ressourcen frei, die von den MessageQueueTransaction verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei.
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
Finalize()

Gibt die Ressourcen frei, die von der aktuellen Instanz gehalten werden.
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Threadsicherheit

Dieser Typ ist threadsicher.

Weitere Informationen