MessageEnumerator.RemoveCurrent 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
從佇列中移除目前的訊息,並將訊息傳回至呼叫的應用程式。 移除訊息會將它從佇列中刪除。
多載
RemoveCurrent() |
從異動或非異動性佇列中移除目前的訊息,並將訊息傳回至呼叫的應用程式。 沒有為訊息到達佇列指定逾時。 |
RemoveCurrent(MessageQueueTransaction) |
從異動佇列中移除目前的訊息,並將訊息傳回至呼叫的應用程式。 沒有為訊息到達佇列指定逾時。 |
RemoveCurrent(MessageQueueTransactionType) |
從佇列移除目前的訊息,並將訊息傳回至呼叫的應用程式。 沒有為訊息到達佇列指定逾時。 |
RemoveCurrent(TimeSpan) |
從佇列中移除目前的訊息,並將訊息傳回至呼叫的應用程式。 如果有要移除的訊息,方法會立即將它傳回。 否則,方法會為新訊息的到達等待指定的逾時。 |
RemoveCurrent(TimeSpan, MessageQueueTransaction) |
從異動佇列中移除目前的訊息,並將訊息傳回至呼叫的應用程式。 如果有要移除的訊息,方法會立即將它傳回。 否則,方法會為新訊息的到達等待指定的逾時。 |
RemoveCurrent(TimeSpan, MessageQueueTransactionType) |
從佇列移除目前的訊息,並將訊息傳回至呼叫的應用程式。 如果有要移除的訊息,方法會立即將它傳回。 否則,方法會為新訊息的到達等待指定的逾時。 |
備註
只有在使用 GetMessageEnumerator2擷取 實例時,MessageEnumerator這些多載所述的行為才適用。 請勿使用 GetMessageEnumerator 來擷取的 MessageEnumerator 實例,因為這個方法已被取代。
RemoveCurrent()
從異動或非異動性佇列中移除目前的訊息,並將訊息傳回至呼叫的應用程式。 沒有為訊息到達佇列指定逾時。
public:
System::Messaging::Message ^ RemoveCurrent();
public System.Messaging.Message RemoveCurrent ();
member this.RemoveCurrent : unit -> System.Messaging.Message
Public Function RemoveCurrent () As Message
傳回
Message,參考佇列中的第一個可用訊息。
備註
RemoveCurrent 會移除並傳回游標目前位置的訊息。
如果您使用佇列日誌,移除訊息會導致複本保留在日誌佇列中,就像類別的 Receive 方法一樣MessageQueue。
當您移除目前的訊息時,游標會移至下一個訊息。 呼叫 之後,您不需要呼叫 MoveNextRemoveCurrent。
如果您在交易佇列上呼叫此多載,消息佇列會建立單一內部交易。
另請參閱
適用於
RemoveCurrent(MessageQueueTransaction)
從異動佇列中移除目前的訊息,並將訊息傳回至呼叫的應用程式。 沒有為訊息到達佇列指定逾時。
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
參數
- transaction
- MessageQueueTransaction
指定移除訊息異動的 MessageQueueTransaction 物件。
傳回
Message,參考佇列中的第一個可用訊息。
例外狀況
transaction
參數為 null
。
備註
RemoveCurrent 使用 參數所 transaction
定義的內部交易內容,移除並傳回數據指標目前位置的訊息。
如果您使用佇列日誌,移除訊息會導致複本保留在日誌佇列中,就像類別的 Receive 方法一樣MessageQueue。
使用交易佇列時,交易的復原會導致呼叫 RemoveCurrent 所移除的任何訊息傳回佇列。 在認可交易之前,移除不會復原。
當您移除目前的訊息時,游標會移至下一個訊息。 呼叫 之後,您不需要呼叫 MoveNextRemoveCurrent。
另請參閱
適用於
RemoveCurrent(MessageQueueTransactionType)
從佇列移除目前的訊息,並將訊息傳回至呼叫的應用程式。 沒有為訊息到達佇列指定逾時。
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
參數
- transactionType
- MessageQueueTransactionType
其中一個 MessageQueueTransactionType 值,描述要與訊息相關聯的異動內容的類型。
傳回
Message,參考佇列中的第一個可用訊息。
例外狀況
transactionType
參數不是其中一個 MessageQueueTransactionType 成員。
備註
RemoveCurrent 使用 參數所 transactionType
定義的交易內容,移除並傳回數據指標目前位置的訊息。
Automatic
如果已經附加至您要用來接收訊息之線程的外部交易內容,請指定 transactionType
參數。 指定 Single
是否要以單一內部交易的形式接收訊息。 您可以指定 None
是否要從交易內容外部的交易佇列接收訊息。
如果您使用佇列日誌,移除訊息會導致複本保留在日誌佇列中,就像類別的 Receive 方法一樣MessageQueue。
使用交易佇列時,交易的復原會導致呼叫 RemoveCurrent 所移除的任何訊息傳回佇列。 在認可交易之前,移除不會復原。
當您移除目前的訊息時,游標會移至下一個訊息。 呼叫 之後,您不需要呼叫 MoveNextRemoveCurrent。
另請參閱
適用於
RemoveCurrent(TimeSpan)
從佇列中移除目前的訊息,並將訊息傳回至呼叫的應用程式。 如果有要移除的訊息,方法會立即將它傳回。 否則,方法會為新訊息的到達等待指定的逾時。
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
參數
- timeout
- TimeSpan
等待訊息到達佇列的時間間隔。
傳回
Message,參考佇列中的第一個可用訊息。
例外狀況
為 timeout
參數指定的值無效。
已經逾時。
備註
RemoveCurrent 會移除並傳回游標目前位置的訊息。 如果數據指標位於佇列結尾,此方法的這個多載會等到訊息可用或參數指定的 timeout
間隔已過期為止。
如果您使用佇列日誌,移除訊息會導致複本保留在日誌佇列中,就像類別的 Receive 方法一樣MessageQueue。
當您移除目前的訊息時,游標會移至下一個訊息。 呼叫 之後,您不需要呼叫 MoveNextRemoveCurrent。
如果您在交易佇列上呼叫此多載,消息佇列會建立單一內部交易。
另請參閱
適用於
RemoveCurrent(TimeSpan, MessageQueueTransaction)
從異動佇列中移除目前的訊息,並將訊息傳回至呼叫的應用程式。 如果有要移除的訊息,方法會立即將它傳回。 否則,方法會為新訊息的到達等待指定的逾時。
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
參數
- timeout
- TimeSpan
等待移除訊息的時間間隔。
- transaction
- MessageQueueTransaction
指定訊息異動內容的 MessageQueueTransaction 物件。
傳回
Message,參考佇列中的第一個可用訊息。
例外狀況
為 timeout
參數指定的值無效。
transaction
參數為 null
。
已經逾時。
備註
RemoveCurrent 會移除並傳回游標目前位置的訊息。 如果數據指標位於佇列結尾,此方法的這個多載會等到訊息可用或參數指定的 timeout
間隔已過期為止。
使用交易佇列時,交易的復原會導致呼叫 RemoveCurrent 所移除的任何訊息傳回佇列。 在認可交易之前,移除不會復原。
如果您使用佇列日誌,移除訊息會導致複本保留在日誌佇列中,就像類別的 Receive 方法一樣MessageQueue。
當您移除目前的訊息時,游標會移至下一個訊息。 呼叫 之後,您不需要呼叫 MoveNextRemoveCurrent。
另請參閱
適用於
RemoveCurrent(TimeSpan, MessageQueueTransactionType)
從佇列移除目前的訊息,並將訊息傳回至呼叫的應用程式。 如果有要移除的訊息,方法會立即將它傳回。 否則,方法會為新訊息的到達等待指定的逾時。
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
參數
- timeout
- TimeSpan
等待移除訊息的時間間隔。
- transactionType
- MessageQueueTransactionType
其中一個 MessageQueueTransactionType 值,描述要與訊息相關聯的異動內容的類型。
傳回
Message,參考佇列中的第一個可用訊息。
例外狀況
為 timeout
參數指定的值無效。
已經逾時。
transactionType
參數不是其中一個 MessageQueueTransactionType 成員。
備註
RemoveCurrent 會使用 參數所定義的交易內容,移除並傳回數據指標目前位置的 transactionType
訊息。 如果數據指標位於佇列結尾,此方法的這個多載會等到訊息可用或參數指定的 timeout
間隔已過期為止。
Automatic
如果已經附加至您想要用來接收訊息之線程的外部交易內容,請指定 transactionType
參數。 指定 Single
是否要以單一內部交易的形式接收訊息。 您可以指定 None
是否要從交易內容外部的交易佇列接收訊息。
如果您使用佇列日誌,移除訊息會導致複本保留在日誌佇列中,就像類別的 Receive 方法一樣MessageQueue。
使用交易佇列時,交易的復原會導致呼叫 RemoveCurrent 傳回佇列而移除的任何訊息。 在認可交易之前,移除不會復原。
當您移除目前的訊息時,游標會移至下一個訊息。 您不需要在呼叫 之後呼叫 MoveNextRemoveCurrent。