MessageQueueTransaction MessageQueueTransaction MessageQueueTransaction MessageQueueTransaction Class

Definition

Stellt eine interne Message Queuing-Transaktion bereit.Provides a Message Queuing internal transaction.

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

Hinweise

Um eine Nachricht als Teil einer Transaktion zu senden oder zu empfangen, können Sie die MessageQueueTransaction -Klasse verwenden, um eine Transaktion zu erstellen und an eine MessageQueue.Send Überladung der- MessageQueue.Receive Methode oder der- transaction Methode zu übergeben, die einen-Parameter annimmt.To send or receive a message as part of a transaction, you can use the MessageQueueTransaction class to create a transaction and pass it to an overload of the MessageQueue.Send method or the MessageQueue.Receive method that takes a transaction parameter. Nachrichten, die als Teil einer Transaktion gesendet werden, müssen an Transaktions Warteschlangen gesendet werden.Messages sent as part of a transaction must be sent to transactional queues. Nachrichten, die von Transaktions Warteschlangen empfangen werden, müssen mithilfe einer angegebenen Transaktion empfangen werden.Messages received from transactional queues must be received using a specified transaction.

Neben der Receive -Methode können Sie auch Nachrichten mit einem angegebenen Bezeichner oder einer angegebenen Korrelations-ID empfangen.In addition to the Receive method, you can receive messages with a specified identifier or specified correlation identifier. Weitere Informationen ReceiveById zum ReceiveByCorrelationId selektiven empfangen von Nachrichten aus Transaktions Warteschlangen finden Sie unter den Methoden und.See the ReceiveById and ReceiveByCorrelationId methods for more information about selectively receiving messages from transactional queues.

An Transaktions Warteschlangen gesendete Nachrichten werden entfernt, wenn für die Transaktion ein Commit ausgeführt wird.Messages sent to transactional queues are removed if the transaction is committed. Ebenso werden von transaktionalen Warteschlangen empfangene Nachrichten an die Warteschlange zurückgegeben, wenn für die Transaktion ein Rollback ausgeführt wird.Similarly, messages received from transactional queues are returned to the queue if the transaction is rolled back.

Wenn Sie einen MessageQueueTransaction instanziieren und ihn an eine anwendbare Send Überladung der-Methode oder Receive -Methode übergeben, um eine Nachricht an eine nicht transaktionale Warteschlange zu senden oder eine Nachricht von einer nicht transaktionalen Warteschlange zu empfangen, löst die Methode eine Ausnahme aus, die gibt "falsche Transaktions Verwendung" an.If you instantiate a MessageQueueTransaction and pass it to an applicable overload of the Send method or Receive method to send a message to a non-transactional queue or receive a message from a non-transactional queue, the method throws an exception that indicates "Wrong Transaction Usage."

MessageQueueTransactionist Thread-Apartment-fähig, sodass Sie die Transaktion nicht STAin mehreren Threads verwenden können, wenn der Apartment Zustand ist.MessageQueueTransaction is threading apartment aware, so if your apartment state is STA, you cannot use the transaction in multiple threads. Visual Basic legt den Status des Haupt Threads auf STAfest, sodass Sie den MTAThreadAttribute in der Main Unterroutine anwenden müssen.Visual Basic sets the state of the main thread to STA, so you must apply the MTAThreadAttribute in the Main subroutine. Andernfalls wird durch das Senden einer Transaktionsmeldung mithilfe eines anderen Threads eine MessageQueueException-Ausnahme ausgelöst.Otherwise, sending a transactional message using another thread throws a MessageQueueException exception. Sie wenden das MTAThreadAttribute mit dem folgenden Fragment an.You apply the MTAThreadAttribute by using the following fragment.

<System.MTAThreadAttribute>  
 public sub Main()  

Konstruktoren

MessageQueueTransaction() MessageQueueTransaction() MessageQueueTransaction() MessageQueueTransaction()

Initialisiert eine neue Instanz der MessageQueueTransaction-Klasse.Initializes a new instance of the MessageQueueTransaction class.

Eigenschaften

Status Status Status Status

Ruft den Status der Transaktion ab.Gets the status of the transaction.

Methoden

Abort() Abort() Abort() Abort()

Führt einen Rollback der anstehenden internen Transaktion aus.Rolls back the pending internal transaction.

Begin() Begin() Begin() Begin()

Beginnt eine neue interne Message Queuing-Transaktion.Begins a new Message Queuing internal transaction.

Commit() Commit() Commit() Commit()

Führt einen Commit für eine anstehende interne Transaktion aus.Commits a pending internal transaction.

Dispose() Dispose() Dispose() Dispose()

Gibt alle vom MessageQueueTransaction verwendeten Ressourcen frei.Releases all resources used by the MessageQueueTransaction.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von MessageQueueTransaction verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the MessageQueueTransaction and optionally releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

Gibt die von der aktuellen Instanz reservierten Ressourcen frei.Releases the resources held by the current instance.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Threadsicherheit

Dieser Typ ist threadsicher.This type is thread safe.

Siehe auch