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 Nachricht aus der Warteschlange und gibt die Nachricht an die aufrufende Anwendung zurück. Wenn Sie die Nachricht entfernen, wird sie aus der Warteschlange gelöscht.
Überlädt
| RemoveCurrent() |
Entfernt die aktuelle Nachricht aus einer transaktionsbezogenen oder nicht transaktionsbezogenen Warteschlange und gibt die Nachricht an die aufrufende Anwendung zurück. Es ist kein Timeout angegeben, damit eine Nachricht in der Warteschlange eintreffen kann. |
| RemoveCurrent(MessageQueueTransaction) |
Entfernt die aktuelle Nachricht aus einer Transaktionswarteschlange und gibt die Nachricht an die aufrufende Anwendung zurück. Es ist kein Timeout angegeben, damit eine Nachricht in der Warteschlange eintreffen kann. |
| RemoveCurrent(MessageQueueTransactionType) |
Entfernt die aktuelle Nachricht aus einer Warteschlange und gibt die Nachricht an die aufrufende Anwendung zurück. Es ist kein Timeout angegeben, damit eine Nachricht in der Warteschlange eintreffen kann. |
| RemoveCurrent(TimeSpan) |
Entfernt die aktuelle Nachricht aus der Warteschlange und gibt die Nachricht an die aufrufende Anwendung zurück. Wenn eine Nachricht entfernt werden soll, gibt die Methode sie sofort zurück. Andernfalls wartet die Methode auf das angegebene Timeout, bis eine neue Nachricht eingeht. |
| RemoveCurrent(TimeSpan, MessageQueueTransaction) |
Entfernt die aktuelle Nachricht aus einer Transaktionswarteschlange und gibt die Nachricht an die aufrufende Anwendung zurück. Wenn eine Nachricht entfernt werden soll, gibt die Methode sie sofort zurück. Andernfalls wartet die Methode auf das angegebene Timeout, bis eine neue Nachricht eingeht. |
| RemoveCurrent(TimeSpan, MessageQueueTransactionType) |
Entfernt die aktuelle Nachricht aus einer Warteschlange und gibt die Nachricht an die aufrufende Anwendung zurück. Wenn eine Nachricht entfernt werden soll, gibt die Methode sie sofort zurück. Andernfalls wartet die Methode auf das angegebene Timeout, bis eine neue Nachricht eingeht. |
Hinweise
Das für diese Überladungen beschriebene Verhalten gilt nur, wenn die MessageEnumerator Instanz mithilfe der GetMessageEnumerator2abgerufen wird. Verwenden Sie GetMessageEnumerator nicht, um eine Instanz von MessageEnumerator abzurufen, da diese Methode veraltet ist.
RemoveCurrent()
Entfernt die aktuelle Nachricht aus einer transaktionsbezogenen oder nicht transaktionsbezogenen Warteschlange und gibt die Nachricht an die aufrufende Anwendung zurück. Es ist kein Timeout angegeben, damit eine Nachricht in der Warteschlange eintreffen kann.
public:
System::Messaging::Message ^ RemoveCurrent();public System.Messaging.Message RemoveCurrent ();member this.RemoveCurrent : unit -> System.Messaging.MessagePublic Function RemoveCurrent () As MessageGibt zurück
Eine Message, die auf die erste nachricht verweist, die in der Warteschlange verfügbar ist.
Hinweise
RemoveCurrent entfernt und gibt die Nachricht an der aktuellen Position des Cursors zurück.
Wenn Sie warteschlangenjournaling verwenden, bewirkt das Entfernen der Nachricht, dass eine Kopie in der Journalwarteschlange gespeichert wird, genau wie die Receive-Methode der MessageQueue Klasse.
Wenn Sie die aktuelle Nachricht entfernen, wird der Cursor in die nächste Nachricht verschoben. Sie müssen nach dem Aufrufen von RemoveCurrentnicht MoveNext anrufen.
Wenn Sie diese Überladung in einer Transaktionswarteschlange aufrufen, erstellt Message Queuing eine einzelne interne Transaktion.
Weitere Informationen
Gilt für:
RemoveCurrent(MessageQueueTransaction)
Entfernt die aktuelle Nachricht aus einer Transaktionswarteschlange und gibt die Nachricht an die aufrufende Anwendung zurück. Es ist kein Timeout angegeben, damit eine Nachricht in der Warteschlange eintreffen kann.
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.MessagePublic Function RemoveCurrent (transaction As MessageQueueTransaction) As MessageParameter
- transaction
- MessageQueueTransaction
Das MessageQueueTransaction-Objekt, das die Transaktion angibt, in der die Nachricht entfernt wird.
Gibt zurück
Eine Message, die auf die erste nachricht verweist, die in der Warteschlange verfügbar ist.
Ausnahmen
Der parameter transaction ist null.
Hinweise
RemoveCurrent entfernt und gibt die Nachricht an der aktuellen Position des Cursors mithilfe des internen Transaktionskontexts zurück, der durch den parameter transaction definiert wird.
Wenn Sie warteschlangenjournaling verwenden, bewirkt das Entfernen der Nachricht, dass eine Kopie in der Journalwarteschlange gespeichert wird, genau wie die Receive-Methode der MessageQueue Klasse.
Wenn Sie mit Transaktionswarteschlangen arbeiten, bewirkt ein Rollback einer Transaktion, dass alle Nachrichten, die von einem Aufruf an RemoveCurrent entfernt wurden, an die Warteschlange zurückgegeben werden. Die Entfernung ist erst unumkehrbar, wenn die Transaktion zugesichert wurde.
Wenn Sie die aktuelle Nachricht entfernen, wird der Cursor in die nächste Nachricht verschoben. Sie müssen nach dem Aufrufen von RemoveCurrentnicht MoveNext anrufen.
Weitere Informationen
Gilt für:
RemoveCurrent(MessageQueueTransactionType)
Entfernt die aktuelle Nachricht aus einer Warteschlange und gibt die Nachricht an die aufrufende Anwendung zurück. Es ist kein Timeout angegeben, damit eine Nachricht in der Warteschlange eintreffen kann.
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.MessagePublic Function RemoveCurrent (transactionType As MessageQueueTransactionType) As MessageParameter
- transactionType
- MessageQueueTransactionType
Einer der MessageQueueTransactionType Werte, der den Typ des Transaktionskontexts beschreibt, der der Nachricht zugeordnet werden soll.
Gibt zurück
Eine Message, die auf die erste nachricht verweist, die in der Warteschlange verfügbar ist.
Ausnahmen
Der parameter transactionType ist keines der MessageQueueTransactionType Member.
Hinweise
RemoveCurrent entfernt und gibt die Nachricht an der aktuellen Position des Cursors mithilfe eines durch den parameter transactionType definierten Transaktionskontexts zurück.
Geben Sie Automatic für den parameter transactionType an, wenn bereits ein externer Transaktionskontext mit dem Thread verbunden ist, den Sie zum Empfangen der Nachricht verwenden möchten. Geben Sie Single an, wenn Sie die Nachricht als einzelne interne Transaktion empfangen möchten. Sie können None angeben, wenn Sie eine Nachricht aus einer Transaktionswarteschlange außerhalb eines Transaktionskontexts empfangen möchten.
Wenn Sie warteschlangenjournaling verwenden, bewirkt das Entfernen der Nachricht, dass eine Kopie in der Journalwarteschlange gespeichert wird, genau wie die Receive-Methode der MessageQueue Klasse.
Wenn Sie mit Transaktionswarteschlangen arbeiten, bewirkt ein Rollback einer Transaktion, dass alle Nachrichten, die von einem Aufruf an RemoveCurrent entfernt wurden, an die Warteschlange zurückgegeben werden. Die Entfernung ist erst unumkehrbar, wenn die Transaktion zugesichert wurde.
Wenn Sie die aktuelle Nachricht entfernen, wird der Cursor in die nächste Nachricht verschoben. Sie müssen nach dem Aufrufen von RemoveCurrentnicht MoveNext anrufen.
Weitere Informationen
Gilt für:
RemoveCurrent(TimeSpan)
Entfernt die aktuelle Nachricht aus der Warteschlange und gibt die Nachricht an die aufrufende Anwendung zurück. Wenn eine Nachricht entfernt werden soll, gibt die Methode sie sofort zurück. Andernfalls wartet die Methode auf das angegebene Timeout, bis eine neue Nachricht eingeht.
public:
System::Messaging::Message ^ RemoveCurrent(TimeSpan timeout);public System.Messaging.Message RemoveCurrent (TimeSpan timeout);member this.RemoveCurrent : TimeSpan -> System.Messaging.MessagePublic Function RemoveCurrent (timeout As TimeSpan) As MessageParameter
- timeout
- TimeSpan
Das Zeitintervall für die Wartezeit, bis eine Nachricht in der Warteschlange eingetroffen ist.
Gibt zurück
Eine Message, die auf die erste nachricht verweist, die in der Warteschlange verfügbar ist.
Ausnahmen
Der für den parameter timeout angegebene Wert ist ungültig.
Das Timeout ist abgelaufen.
Hinweise
RemoveCurrent entfernt und gibt die Nachricht an der aktuellen Position des Cursors 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 Parameter timeout angegebene Intervall abgelaufen ist.
Wenn Sie warteschlangenjournaling verwenden, bewirkt das Entfernen der Nachricht, dass eine Kopie in der Journalwarteschlange gespeichert wird, genau wie die Receive-Methode der MessageQueue Klasse.
Wenn Sie die aktuelle Nachricht entfernen, wird der Cursor in die nächste Nachricht verschoben. Sie müssen nach dem Aufrufen von RemoveCurrentnicht MoveNext anrufen.
Wenn Sie diese Überladung in einer Transaktionswarteschlange aufrufen, erstellt Message Queuing eine einzelne interne Transaktion.
Weitere Informationen
Gilt für:
RemoveCurrent(TimeSpan, MessageQueueTransaction)
Entfernt die aktuelle Nachricht aus einer Transaktionswarteschlange und gibt die Nachricht an die aufrufende Anwendung zurück. Wenn eine Nachricht entfernt werden soll, gibt die Methode sie sofort zurück. Andernfalls wartet die Methode auf das angegebene Timeout, bis eine neue Nachricht eingeht.
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.MessagePublic Function RemoveCurrent (timeout As TimeSpan, transaction As MessageQueueTransaction) As MessageParameter
- timeout
- TimeSpan
Das Zeitintervall für die Wartezeit, bis die Nachricht entfernt wird.
- transaction
- MessageQueueTransaction
Das MessageQueueTransaction-Objekt, das den Transaktionskontext für die Nachricht angibt.
Gibt zurück
Eine Message, die auf die erste nachricht verweist, die in der Warteschlange verfügbar ist.
Ausnahmen
Der für den parameter timeout angegebene Wert ist ungültig.
Der parameter transaction ist null.
Das Timeout ist abgelaufen.
Hinweise
RemoveCurrent entfernt und gibt die Nachricht an der aktuellen Position des Cursors 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 Parameter timeout angegebene Intervall abgelaufen ist.
Wenn Sie mit Transaktionswarteschlangen arbeiten, bewirkt ein Rollback einer Transaktion, dass alle Nachrichten, die von einem Aufruf an RemoveCurrent entfernt wurden, an die Warteschlange zurückgegeben werden. Die Entfernung ist erst unumkehrbar, wenn die Transaktion zugesichert wurde.
Wenn Sie warteschlangenjournaling verwenden, bewirkt das Entfernen der Nachricht, dass eine Kopie in der Journalwarteschlange gespeichert wird, genau wie die Receive-Methode der MessageQueue Klasse.
Wenn Sie die aktuelle Nachricht entfernen, wird der Cursor in die nächste Nachricht verschoben. Sie müssen nach dem Aufrufen von RemoveCurrentnicht MoveNext anrufen.
Weitere Informationen
Gilt für:
RemoveCurrent(TimeSpan, MessageQueueTransactionType)
Entfernt die aktuelle Nachricht aus einer Warteschlange und gibt die Nachricht an die aufrufende Anwendung zurück. Wenn eine Nachricht entfernt werden soll, gibt die Methode sie sofort zurück. Andernfalls wartet die Methode auf das angegebene Timeout, bis eine neue Nachricht eingeht.
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.MessagePublic Function RemoveCurrent (timeout As TimeSpan, transactionType As MessageQueueTransactionType) As MessageParameter
- timeout
- TimeSpan
Das Zeitintervall für die Wartezeit, bis die Nachricht entfernt wird.
- transactionType
- MessageQueueTransactionType
Einer der MessageQueueTransactionType Werte, der den Typ des Transaktionskontexts beschreibt, der der Nachricht zugeordnet werden soll.
Gibt zurück
Eine Message, die auf die erste nachricht verweist, die in der Warteschlange verfügbar ist.
Ausnahmen
Der für den parameter timeout angegebene Wert ist ungültig.
Das Timeout ist abgelaufen.
Der parameter transactionType ist keines der MessageQueueTransactionType Member.
Hinweise
RemoveCurrent entfernt und gibt die Nachricht an der aktuellen Position des Cursors mithilfe eines durch den parameter transactionType 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 Parameter timeout angegebene Intervall abgelaufen ist.
Geben Sie Automatic für den parameter transactionType an, wenn bereits ein externer Transaktionskontext mit dem Thread verbunden ist, den Sie zum Empfangen der Nachricht verwenden möchten. Geben Sie Single an, wenn Sie die Nachricht als einzelne interne Transaktion empfangen möchten. Sie können None angeben, wenn Sie eine Nachricht aus einer Transaktionswarteschlange außerhalb eines Transaktionskontexts empfangen möchten.
Wenn Sie warteschlangenjournaling verwenden, bewirkt das Entfernen der Nachricht, dass eine Kopie in der Journalwarteschlange gespeichert wird, genau wie die Receive-Methode der MessageQueue Klasse.
Wenn Sie mit Transaktionswarteschlangen arbeiten, bewirkt ein Rollback einer Transaktion, dass alle Nachrichten, die von einem Aufruf an RemoveCurrent entfernt wurden, an die Warteschlange zurückgegeben werden. Die Entfernung ist erst unumkehrbar, wenn die Transaktion zugesichert wurde.
Wenn Sie die aktuelle Nachricht entfernen, wird der Cursor in die nächste Nachricht verschoben. Sie müssen nach dem Aufrufen von RemoveCurrentnicht MoveNext anrufen.
