MessageEnumerator.RemoveCurrent 方法

定義

命名空間:

System.Messaging

組件:

System.Messaging.dll

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

多載

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

Message，參考佇列中的第一個可用訊息。

備註

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

如果您使用佇列日誌，移除訊息會導致複本保留在日誌佇列中，就像類別的 Receive 方法一樣MessageQueue。

當您移除目前的訊息時，游標會移至下一個訊息。 呼叫 之後，您不需要呼叫 MoveNextRemoveCurrent。

如果您在交易佇列上呼叫此多載，消息佇列會建立單一內部交易。

另請參閱

• MoveNext()
• Current

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，參考佇列中的第一個可用訊息。

例外狀況

ArgumentNullException

transaction 參數為 null。

備註

RemoveCurrent 使用 參數所 transaction 定義的內部交易內容，移除並傳回數據指標目前位置的訊息。

如果您使用佇列日誌，移除訊息會導致複本保留在日誌佇列中，就像類別的 Receive 方法一樣MessageQueue。

使用交易佇列時，交易的復原會導致呼叫 RemoveCurrent 所移除的任何訊息傳回佇列。 在認可交易之前，移除不會復原。

當您移除目前的訊息時，游標會移至下一個訊息。 呼叫 之後，您不需要呼叫 MoveNextRemoveCurrent。

另請參閱

• MoveNext()
• Current
• MessageQueueTransaction

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，參考佇列中的第一個可用訊息。

例外狀況

InvalidEnumArgumentException

transactionType 參數不是其中一個 MessageQueueTransactionType 成員。

備註

RemoveCurrent 使用 參數所 transactionType 定義的交易內容，移除並傳回數據指標目前位置的訊息。

Automatic如果已經附加至您要用來接收訊息之線程的外部交易內容，請指定 transactionType 參數。 指定 Single 是否要以單一內部交易的形式接收訊息。 您可以指定 None 是否要從交易內容外部的交易佇列接收訊息。

如果您使用佇列日誌，移除訊息會導致複本保留在日誌佇列中，就像類別的 Receive 方法一樣MessageQueue。

使用交易佇列時，交易的復原會導致呼叫 RemoveCurrent 所移除的任何訊息傳回佇列。 在認可交易之前，移除不會復原。

當您移除目前的訊息時，游標會移至下一個訊息。 呼叫 之後，您不需要呼叫 MoveNextRemoveCurrent。

另請參閱

• MoveNext()
• Current
• MessageQueueTransactionType

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，參考佇列中的第一個可用訊息。

例外狀況

ArgumentException

為 timeout 參數指定的值無效。

MessageQueueException

已經逾時。

備註

RemoveCurrent 會移除並傳回游標目前位置的訊息。 如果數據指標位於佇列結尾，此方法的這個多載會等到訊息可用或參數指定的 timeout 間隔已過期為止。

如果您使用佇列日誌，移除訊息會導致複本保留在日誌佇列中，就像類別的 Receive 方法一樣MessageQueue。

當您移除目前的訊息時，游標會移至下一個訊息。 呼叫 之後，您不需要呼叫 MoveNextRemoveCurrent。

如果您在交易佇列上呼叫此多載，消息佇列會建立單一內部交易。

另請參閱

• MoveNext()
• Current

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，參考佇列中的第一個可用訊息。

例外狀況

ArgumentException

為 timeout 參數指定的值無效。

ArgumentNullException

transaction 參數為 null。

MessageQueueException

已經逾時。

備註

RemoveCurrent 會移除並傳回游標目前位置的訊息。 如果數據指標位於佇列結尾，此方法的這個多載會等到訊息可用或參數指定的 timeout 間隔已過期為止。

使用交易佇列時，交易的復原會導致呼叫 RemoveCurrent 所移除的任何訊息傳回佇列。 在認可交易之前，移除不會復原。

如果您使用佇列日誌，移除訊息會導致複本保留在日誌佇列中，就像類別的 Receive 方法一樣MessageQueue。

當您移除目前的訊息時，游標會移至下一個訊息。 呼叫 之後，您不需要呼叫 MoveNextRemoveCurrent。

另請參閱

• MoveNext()
• Current
• MessageQueueTransaction

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，參考佇列中的第一個可用訊息。

例外狀況

ArgumentException

為 timeout 參數指定的值無效。

MessageQueueException

已經逾時。

InvalidEnumArgumentException

transactionType 參數不是其中一個 MessageQueueTransactionType 成員。

備註

RemoveCurrent 會使用 參數所定義的交易內容，移除並傳回數據指標目前位置的 transactionType 訊息。 如果數據指標位於佇列結尾，此方法的這個多載會等到訊息可用或參數指定的 timeout 間隔已過期為止。

Automatic如果已經附加至您想要用來接收訊息之線程的外部交易內容，請指定 transactionType 參數。 指定 Single 是否要以單一內部交易的形式接收訊息。 您可以指定 None 是否要從交易內容外部的交易佇列接收訊息。

如果您使用佇列日誌，移除訊息會導致複本保留在日誌佇列中，就像類別的 Receive 方法一樣MessageQueue。

使用交易佇列時，交易的復原會導致呼叫 RemoveCurrent 傳回佇列而移除的任何訊息。 在認可交易之前，移除不會復原。

當您移除目前的訊息時，游標會移至下一個訊息。 您不需要在呼叫 之後呼叫 MoveNextRemoveCurrent。

另請參閱

• MoveNext()
• Current
• MessageQueueTransactionType