MessageEnumerator.RemoveCurrent Methode
Definition
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.
Entfernt die aktuelle Meldung aus der Warteschlange und gibt die Meldung an die aufrufende Anwendung zurück. Durch das Entfernen einer Meldung wird diese aus der Warteschlange gelöscht.
Überlädt
RemoveCurrent() |
Entfernt die aktuelle Meldung aus einer transaktionalen oder nicht transaktionalen Warteschlange und gibt die Meldung an die aufrufende Anwendung zurück. Für das Eintreffen einer Meldung in der Warteschlange ist kein Timeout festgelegt. |
RemoveCurrent(MessageQueueTransaction) |
Entfernt die aktuelle Meldung aus einer transaktionalen Warteschlange und gibt die Meldung an die aufrufende Anwendung zurück. Für das Eintreffen einer Meldung in der Warteschlange ist kein Timeout festgelegt. |
RemoveCurrent(MessageQueueTransactionType) |
Entfernt die aktuelle Meldung aus einer Warteschlange und gibt die Meldung an die aufrufende Anwendung zurück. Für das Eintreffen einer Meldung in der Warteschlange ist kein Timeout festgelegt. |
RemoveCurrent(TimeSpan) |
Entfernt die aktuelle Meldung aus der Warteschlange und gibt die Meldung an die aufrufende Anwendung zurück. Wenn eine vorhandene Meldung entfernt werden kann, wird diese von der Methode sofort zurückgegeben. Andernfalls wartet die Methode auf das Eingehen einer neuen Meldung, bis der angegebene Timeout überschritten wird. |
RemoveCurrent(TimeSpan, MessageQueueTransaction) |
Entfernt die aktuelle Meldung aus einer transaktionalen Warteschlange und gibt die Meldung an die aufrufende Anwendung zurück. Wenn eine vorhandene Meldung entfernt werden kann, wird diese von der Methode sofort zurückgegeben. Andernfalls wartet die Methode auf das Eingehen einer neuen Meldung, bis der angegebene Timeout überschritten wird. |
RemoveCurrent(TimeSpan, MessageQueueTransactionType) |
Entfernt die aktuelle Meldung aus einer Warteschlange und gibt die Meldung an die aufrufende Anwendung zurück. Wenn eine vorhandene Meldung entfernt werden kann, wird diese von der Methode sofort zurückgegeben. Andernfalls wartet die Methode auf das Eingehen einer neuen Meldung, bis der angegebene Timeout überschritten wird. |
Hinweise
Das für diese Überladungen beschriebene Verhalten gilt nur, wenn die MessageEnumerator instance mithilfe von GetMessageEnumerator2abgerufen wird. Verwenden GetMessageEnumerator Sie nicht , um eine instance von MessageEnumerator abzurufen, da diese Methode veraltet ist.
RemoveCurrent()
Entfernt die aktuelle Meldung aus einer transaktionalen oder nicht transaktionalen Warteschlange und gibt die Meldung an die aufrufende Anwendung zurück. Für das Eintreffen einer Meldung in der Warteschlange ist kein Timeout festgelegt.
public:
System::Messaging::Message ^ RemoveCurrent();
public System.Messaging.Message RemoveCurrent ();
member this.RemoveCurrent : unit -> System.Messaging.Message
Public Function RemoveCurrent () As Message
Gibt zurück
Eine Message, die auf die erste Meldung in der Warteschlange verweist.
Hinweise
RemoveCurrent entfernt die Nachricht an der aktuellen Position des Cursors und gibt sie zurück.
Wenn Sie Warteschlangenjournaling verwenden, führt das Entfernen der Nachricht dazu, dass eine Kopie in der Journalwarteschlange aufbewahrt wird, genau wie die -Methode der MessageQueue -Klasse Receive .
Wenn Sie die aktuelle Nachricht entfernen, wird der Cursor zur nächsten Nachricht verschoben. Sie müssen nicht aufrufen MoveNext , nachdem Sie aufgerufen RemoveCurrenthaben.
Wenn Sie diese Überladung für eine Transaktionswarteschlange aufrufen, erstellt Message Queuing eine einzelne interne Transaktion.
Weitere Informationen
Gilt für:
RemoveCurrent(MessageQueueTransaction)
Entfernt die aktuelle Meldung aus einer transaktionalen Warteschlange und gibt die Meldung an die aufrufende Anwendung zurück. Für das Eintreffen einer Meldung in der Warteschlange ist kein Timeout festgelegt.
public:
System::Messaging::Message ^ RemoveCurrent(System::Messaging::MessageQueueTransaction ^ transaction);
public System.Messaging.Message RemoveCurrent (System.Messaging.MessageQueueTransaction transaction);
member this.RemoveCurrent : System.Messaging.MessageQueueTransaction -> System.Messaging.Message
Public Function RemoveCurrent (transaction As MessageQueueTransaction) As Message
Parameter
- transaction
- MessageQueueTransaction
Dieses MessageQueueTransaction-Objekt stellt die Transaktion dar, innerhalb der die Meldung entfernt wird.
Gibt zurück
Eine Message, die auf die erste Meldung in der Warteschlange verweist.
Ausnahmen
Der transaction
-Parameter ist null
.
Hinweise
RemoveCurrent entfernt die Nachricht an der aktuellen Position des Cursors und gibt sie mithilfe des durch den transaction
Parameter definierten internen Transaktionskontexts zurück.
Wenn Sie Warteschlangenjournaling verwenden, führt das Entfernen der Nachricht dazu, dass eine Kopie in der Journalwarteschlange aufbewahrt wird, genau wie die -Methode der MessageQueue -Klasse Receive .
Bei der Arbeit mit Transaktionswarteschlangen führt ein Rollback einer Transaktion dazu, dass alle nachrichten, die durch einen Aufruf RemoveCurrent von entfernt wurden, an die Warteschlange zurückgegeben werden. Die Entfernung kann erst rückgängig gemacht werden, wenn ein Commit für die Transaktion ausgeführt wird.
Wenn Sie die aktuelle Nachricht entfernen, wird der Cursor zur nächsten Nachricht verschoben. Sie müssen nicht aufrufen MoveNext , nachdem Sie aufgerufen RemoveCurrenthaben.
Weitere Informationen
Gilt für:
RemoveCurrent(MessageQueueTransactionType)
Entfernt die aktuelle Meldung aus einer Warteschlange und gibt die Meldung an die aufrufende Anwendung zurück. Für das Eintreffen einer Meldung in der Warteschlange ist kein Timeout festgelegt.
public:
System::Messaging::Message ^ RemoveCurrent(System::Messaging::MessageQueueTransactionType transactionType);
public System.Messaging.Message RemoveCurrent (System.Messaging.MessageQueueTransactionType transactionType);
member this.RemoveCurrent : System.Messaging.MessageQueueTransactionType -> System.Messaging.Message
Public Function RemoveCurrent (transactionType As MessageQueueTransactionType) As Message
Parameter
- transactionType
- MessageQueueTransactionType
Einer der MessageQueueTransactionType-Werte, der den Typ des Transaktionskontexts beschreibt, der der Meldung zugeordnet werden soll.
Gibt zurück
Eine Message, die auf die erste Meldung in der Warteschlange verweist.
Ausnahmen
Der transactionType
-Parameter ist keiner der MessageQueueTransactionType-Member.
Hinweise
RemoveCurrent entfernt die Nachricht an der aktuellen Position des Cursors und gibt sie mithilfe eines durch den transactionType
Parameter definierten Transaktionskontexts zurück.
Geben Sie Automatic
für den transactionType
Parameter an, wenn bereits ein externer Transaktionskontext an den Thread angefügt ist, den Sie zum Empfangen der Nachricht verwenden möchten. Geben Sie an Single
, ob Sie die Nachricht als einzelne interne Transaktion empfangen möchten. Sie können angeben None
, ob Sie eine Nachricht von einer Transaktionswarteschlange außerhalb eines Transaktionskontexts empfangen möchten.
Wenn Sie Warteschlangenjournaling verwenden, führt das Entfernen der Nachricht dazu, dass eine Kopie in der Journalwarteschlange aufbewahrt wird, genau wie die -Methode der MessageQueue -Klasse Receive .
Bei der Arbeit mit Transaktionswarteschlangen führt ein Rollback einer Transaktion dazu, dass alle nachrichten, die durch einen Aufruf RemoveCurrent von entfernt wurden, an die Warteschlange zurückgegeben werden. Die Entfernung kann erst rückgängig gemacht werden, wenn ein Commit für die Transaktion ausgeführt wird.
Wenn Sie die aktuelle Nachricht entfernen, wird der Cursor zur nächsten Nachricht verschoben. Sie müssen nicht aufrufen MoveNext , nachdem Sie aufgerufen RemoveCurrenthaben.
Weitere Informationen
Gilt für:
RemoveCurrent(TimeSpan)
Entfernt die aktuelle Meldung aus der Warteschlange und gibt die Meldung an die aufrufende Anwendung zurück. Wenn eine vorhandene Meldung entfernt werden kann, wird diese von der Methode sofort zurückgegeben. Andernfalls wartet die Methode auf das Eingehen einer neuen Meldung, bis der angegebene Timeout überschritten wird.
public:
System::Messaging::Message ^ RemoveCurrent(TimeSpan timeout);
public System.Messaging.Message RemoveCurrent (TimeSpan timeout);
member this.RemoveCurrent : TimeSpan -> System.Messaging.Message
Public Function RemoveCurrent (timeout As TimeSpan) As Message
Parameter
- timeout
- TimeSpan
Die Zeit, die auf das Eintreffen einer Meldung gewartet werden soll.
Gibt zurück
Eine Message, die auf die erste Meldung in der Warteschlange verweist.
Ausnahmen
Der für den timeout
-Parameter angegebene Wert ist ungültig.
Der Timeout wurde überschritten.
Hinweise
RemoveCurrent entfernt die Nachricht an der aktuellen Position des Cursors und gibt sie zurück. Wenn sich der Cursor am Ende der Warteschlange befindet, wartet diese Überladung der -Methode, bis eine Nachricht verfügbar ist oder das durch den timeout
Parameter angegebene Intervall abgelaufen ist.
Wenn Sie Warteschlangenjournaling verwenden, führt das Entfernen der Nachricht dazu, dass eine Kopie in der Journalwarteschlange aufbewahrt wird, genau wie die -Methode der MessageQueue -Klasse Receive .
Wenn Sie die aktuelle Nachricht entfernen, wird der Cursor zur nächsten Nachricht verschoben. Sie müssen nicht aufrufen MoveNext , nachdem Sie aufgerufen RemoveCurrenthaben.
Wenn Sie diese Überladung für eine Transaktionswarteschlange aufrufen, erstellt Message Queuing eine einzelne interne Transaktion.
Weitere Informationen
Gilt für:
RemoveCurrent(TimeSpan, MessageQueueTransaction)
Entfernt die aktuelle Meldung aus einer transaktionalen Warteschlange und gibt die Meldung an die aufrufende Anwendung zurück. Wenn eine vorhandene Meldung entfernt werden kann, wird diese von der Methode sofort zurückgegeben. Andernfalls wartet die Methode auf das Eingehen einer neuen Meldung, bis der angegebene Timeout überschritten wird.
public:
System::Messaging::Message ^ RemoveCurrent(TimeSpan timeout, System::Messaging::MessageQueueTransaction ^ transaction);
public System.Messaging.Message RemoveCurrent (TimeSpan timeout, System.Messaging.MessageQueueTransaction transaction);
member this.RemoveCurrent : TimeSpan * System.Messaging.MessageQueueTransaction -> System.Messaging.Message
Public Function RemoveCurrent (timeout As TimeSpan, transaction As MessageQueueTransaction) As Message
Parameter
- timeout
- TimeSpan
Die Zeitspanne, in der die zu entfernende Meldung eingehen muss.
- transaction
- MessageQueueTransaction
Das MessageQueueTransaction-Objekt, das den Transaktionskontext für diese Meldung angibt.
Gibt zurück
Eine Message, die auf die erste Meldung in der Warteschlange verweist.
Ausnahmen
Der für den timeout
-Parameter angegebene Wert ist ungültig.
Der transaction
-Parameter ist null
.
Der Timeout wurde überschritten.
Hinweise
RemoveCurrent entfernt die Nachricht an der aktuellen Position des Cursors und gibt sie zurück. Wenn sich der Cursor am Ende der Warteschlange befindet, wartet diese Überladung der -Methode, bis eine Nachricht verfügbar ist oder das durch den timeout
Parameter angegebene Intervall abgelaufen ist.
Bei der Arbeit mit Transaktionswarteschlangen führt ein Rollback einer Transaktion dazu, dass alle nachrichten, die durch einen Aufruf RemoveCurrent von entfernt wurden, an die Warteschlange zurückgegeben werden. Die Entfernung kann erst rückgängig gemacht werden, wenn ein Commit für die Transaktion ausgeführt wird.
Wenn Sie Warteschlangenjournaling verwenden, führt das Entfernen der Nachricht dazu, dass eine Kopie in der Journalwarteschlange aufbewahrt wird, genau wie die -Methode der MessageQueue -Klasse Receive .
Wenn Sie die aktuelle Nachricht entfernen, wird der Cursor zur nächsten Nachricht verschoben. Sie müssen nicht aufrufen MoveNext , nachdem Sie aufgerufen RemoveCurrenthaben.
Weitere Informationen
Gilt für:
RemoveCurrent(TimeSpan, MessageQueueTransactionType)
Entfernt die aktuelle Meldung aus einer Warteschlange und gibt die Meldung an die aufrufende Anwendung zurück. Wenn eine vorhandene Meldung entfernt werden kann, wird diese von der Methode sofort zurückgegeben. Andernfalls wartet die Methode auf das Eingehen einer neuen Meldung, bis der angegebene Timeout überschritten wird.
public:
System::Messaging::Message ^ RemoveCurrent(TimeSpan timeout, System::Messaging::MessageQueueTransactionType transactionType);
public System.Messaging.Message RemoveCurrent (TimeSpan timeout, System.Messaging.MessageQueueTransactionType transactionType);
member this.RemoveCurrent : TimeSpan * System.Messaging.MessageQueueTransactionType -> System.Messaging.Message
Public Function RemoveCurrent (timeout As TimeSpan, transactionType As MessageQueueTransactionType) As Message
Parameter
- timeout
- TimeSpan
Die Zeitspanne, in der die zu entfernende Meldung eingehen muss.
- transactionType
- MessageQueueTransactionType
Einer der MessageQueueTransactionType-Werte, der den Typ des Transaktionskontexts beschreibt, der der Meldung zugeordnet werden soll.
Gibt zurück
Eine Message, die auf die erste Meldung in der Warteschlange verweist.
Ausnahmen
Der für den timeout
-Parameter angegebene Wert ist ungültig.
Der Timeout wurde überschritten.
Der transactionType
-Parameter ist keiner der MessageQueueTransactionType-Member.
Hinweise
RemoveCurrent entfernt die Nachricht an der aktuellen Position des Cursors und gibt sie mithilfe eines durch den transactionType
Parameter definierten Transaktionskontexts zurück. Wenn sich der Cursor am Ende der Warteschlange befindet, wartet diese Überladung der -Methode, bis eine Nachricht verfügbar ist oder das durch den timeout
Parameter angegebene Intervall abgelaufen ist.
Geben Sie Automatic
für den transactionType
Parameter an, wenn bereits ein externer Transaktionskontext an den Thread angefügt ist, den Sie zum Empfangen der Nachricht verwenden möchten. Geben Sie an Single
, ob Sie die Nachricht als einzelne interne Transaktion empfangen möchten. Sie können angeben None
, ob Sie eine Nachricht von einer Transaktionswarteschlange außerhalb eines Transaktionskontexts empfangen möchten.
Wenn Sie Warteschlangenjournaling verwenden, führt das Entfernen der Nachricht dazu, dass eine Kopie in der Journalwarteschlange aufbewahrt wird, genau wie die -Methode der MessageQueue -Klasse Receive .
Bei der Arbeit mit Transaktionswarteschlangen führt ein Rollback einer Transaktion dazu, dass alle nachrichten, die durch einen Aufruf RemoveCurrent von entfernt wurden, an die Warteschlange zurückgegeben werden. Die Entfernung kann erst rückgängig gemacht werden, wenn ein Commit für die Transaktion ausgeführt wird.
Wenn Sie die aktuelle Nachricht entfernen, wird der Cursor zur nächsten Nachricht verschoben. Sie müssen nicht aufrufen MoveNext , nachdem Sie aufgerufen RemoveCurrenthaben.