MessageEnumerator.RemoveCurrent 方法

定義

命名空間:: System.Messaging

組件:: System.Messaging.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

從佇列中移除目前訊息，並將訊息回傳給呼叫的應用程式。移除訊息會從排隊中刪除。

多載

名稱	Description
RemoveCurrent()	從交易或非交易隊列中移除目前訊息，並將訊息回傳給呼叫的應用程式。訊息不會指定逾時來讓訊息到達佇列。
RemoveCurrent(MessageQueueTransaction)	從交易佇列中移除目前訊息，並將訊息回傳給呼叫的應用程式。訊息不會指定逾時來讓訊息到達佇列。
RemoveCurrent(MessageQueueTransactionType)	從隊列中移除目前訊息，並將訊息回傳給呼叫的應用程式。訊息不會指定逾時來讓訊息到達佇列。
RemoveCurrent(TimeSpan)	從佇列中移除目前訊息，並將訊息回傳給呼叫的應用程式。如果有訊息需要移除，方法會立即回傳。否則，方法會等待指定的逾時時間，等待新訊息抵達。
RemoveCurrent(TimeSpan, MessageQueueTransaction)	從交易佇列中移除目前訊息，並將訊息回傳給呼叫的應用程式。如果有訊息需要移除，方法會立即回傳。否則，方法會等待指定的逾時時間，等待新訊息抵達。
RemoveCurrent(TimeSpan, MessageQueueTransactionType)	從隊列中移除目前訊息，並將訊息回傳給呼叫的應用程式。如果有訊息需要移除，方法會立即回傳。否則，方法會等待指定的逾時時間，等待新訊息抵達。

備註

這些超載的行為僅MessageEnumerator GetMessageEnumerator2適用於使用以下。請勿使用 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

Message A 指的是佇列中第一個可用的訊息。

備註

RemoveCurrent 移除並回傳游標目前位置的訊息。

如果你使用佇列日誌，移除訊息會像類別Receive的方法一樣，在日誌佇列MessageQueue中保留一份副本。

當你移除目前的訊息時，游標會移到下一則訊息。你不必一打 MoveNext 一遍又一 RemoveCurrent遍。

如果你在交易佇列中呼叫這個超載，訊息佇列會產生單一內部交易。

另請參閱

適用於

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

Message A 指的是佇列中第一個可用的訊息。

例外狀況

ArgumentNullException

參數 transaction 為 null。

備註

RemoveCurrent 利用參數定義 transaction 的內部交易上下文，移除並回傳游標目前位置的訊息。

如果你使用佇列日誌，移除訊息會像類別Receive的方法一樣，在日誌佇列MessageQueue中保留一份副本。

在處理交易佇列時，交易回滾會使呼叫移除 RemoveCurrent 的任何訊息都返回到佇列。移除在交易被承諾之前並非不可逆。

當你移除目前的訊息時，游標會移到下一則訊息。你不必一打 MoveNext 一遍又一 RemoveCurrent遍。

另請參閱

適用於

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

Message A 指的是佇列中第一個可用的訊息。

例外狀況

InvalidEnumArgumentException

參數 transactionType 並非 MessageQueueTransactionType 成員之一。

備註

RemoveCurrent 透過參數定義 transactionType 的交易上下文，移除並返回游標當前位置的訊息。

請指定AutomatictransactionType參數，是否已經連接到你想用來接收訊息的執行緒。請指定 Single 你是否想將訊息作為單一內部交易接收。你可以指定 None 是否想在交易上下文外接收來自交易隊列的訊息。

如果你使用佇列日誌，移除訊息會像類別Receive的方法一樣，在日誌佇列MessageQueue中保留一份副本。

在處理交易佇列時，交易回滾會使呼叫移除 RemoveCurrent 的任何訊息都返回到佇列。移除在交易被承諾之前並非不可逆。

當你移除目前的訊息時，游標會移到下一則訊息。你不必一打 MoveNext 一遍又一 RemoveCurrent遍。

另請參閱

適用於

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

Message A 指的是佇列中第一個可用的訊息。

例外狀況

ArgumentException

參數指定的 timeout 值無效。

MessageQueueException

暫停時間已經過了。

備註

RemoveCurrent 移除並回傳游標目前位置的訊息。若游標位於佇列末端，方法的過載會等待訊息可用或參數指定的 timeout 區間結束。

如果你使用佇列日誌，移除訊息會像類別Receive的方法一樣，在日誌佇列MessageQueue中保留一份副本。

當你移除目前的訊息時，游標會移到下一則訊息。你不必一打 MoveNext 一遍又一 RemoveCurrent遍。

如果你在交易佇列中呼叫這個超載，訊息佇列會產生單一內部交易。

另請參閱

適用於

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

Message A 指的是佇列中第一個可用的訊息。

例外狀況

ArgumentException

參數指定的 timeout 值無效。

ArgumentNullException

參數 transaction 為 null。

MessageQueueException

暫停時間已經過了。

備註

RemoveCurrent 移除並回傳游標目前位置的訊息。若游標位於佇列末端，方法的過載會等待訊息可用或參數指定的 timeout 區間結束。

在處理交易佇列時，交易回滾會使呼叫移除 RemoveCurrent 的任何訊息都返回到佇列。移除在交易被承諾之前並非不可逆。

如果你使用佇列日誌，移除訊息會像類別Receive的方法一樣，在日誌佇列MessageQueue中保留一份副本。

當你移除目前的訊息時，游標會移到下一則訊息。你不必一打 MoveNext 一遍又一 RemoveCurrent遍。

另請參閱

適用於

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

Message A 指的是佇列中第一個可用的訊息。

例外狀況

ArgumentException

參數指定的 timeout 值無效。

MessageQueueException

暫停時間已經過了。

InvalidEnumArgumentException

參數 transactionType 並非 MessageQueueTransactionType 成員之一。

備註

RemoveCurrent 透過參數定義 transactionType 的交易上下文，移除並返回游標當前位置的訊息。若游標位於佇列末端，方法的過載會等待訊息可用或參數指定的 timeout 區間結束。

如果你使用佇列日誌，移除訊息會像類別Receive的方法一樣，在日誌佇列MessageQueue中保留一份副本。

在處理交易佇列時，交易回滾會使呼叫移除 RemoveCurrent 的任何訊息都返回到佇列。移除在交易被承諾之前並非不可逆。

當你移除目前的訊息時，游標會移到下一則訊息。你不必一打 MoveNext 一遍又一 RemoveCurrent遍。

另請參閱

適用於

意見反應

此頁面對您有幫助嗎？