MessageEnumerator.RemoveCurrent Метод

Определение

Пространство имен:

System.Messaging

Сборка:

System.Messaging.dll

Удаляет текущее сообщение из очереди и возвращает сообщение в вызывающее приложение. При удалении сообщения оно стирается из очереди.

Перегрузки

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, ссылающийся на первое доступное в очереди сообщение.

Комментарии

RemoveCurrent удаляет и возвращает сообщение в текущем расположении курсора.

Если вы используете ведение журнала в очереди, удаление сообщения приведет к тому, что копия будет сохранена Receive в очереди журнала, как MessageQueue это делает метод класса.

При удалении текущего сообщения курсор перемещается к следующему сообщению. Вам не нужно звонить MoveNext после вызова RemoveCurrent.

При вызове этой перегрузки в очереди транзакций очередь сообщений создает одну внутреннюю транзакцию.

См. также раздел

• 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 тому, что все сообщения, удаленные вызовом , возвращаются в очередь. Удаление не является необратимым, пока транзакция не будет зафиксирована.

При удалении текущего сообщения курсор перемещается к следующему сообщению. Вам не нужно звонить MoveNext после вызова RemoveCurrent.

См. также раздел

• 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 тому, что все сообщения, удаленные вызовом , возвращаются в очередь. Удаление не является необратимым, пока транзакция не будет зафиксирована.

При удалении текущего сообщения курсор перемещается к следующему сообщению. Вам не нужно звонить MoveNext после вызова RemoveCurrent.

См. также раздел

• 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 это делает метод класса.

При удалении текущего сообщения курсор перемещается к следующему сообщению. Вам не нужно звонить MoveNext после вызова RemoveCurrent.

При вызове этой перегрузки в очереди транзакций очередь сообщений создает одну внутреннюю транзакцию.

См. также раздел

• 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 это делает метод класса.

При удалении текущего сообщения курсор перемещается к следующему сообщению. Вам не нужно звонить MoveNext после вызова RemoveCurrent.

См. также раздел

• 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 , хотите ли вы получать сообщение из очереди транзакций вне контекста транзакции.

Если вы используете ведение журнала очереди, удаление сообщения приведет к тому, что копия будет храниться в очереди журнала так же, как MessageQueue это делает метод класса Receive .

При работе с транзакционной очередью откат транзакции приводит к RemoveCurrent возврату в очередь всех сообщений, удаленных вызовом. Удаление не является необратимым, пока транзакция не будет зафиксирована.

При удалении текущего сообщения курсор перемещается к следующему сообщению. Вам не нужно вызывать MoveNext после вызова RemoveCurrent.

См. также раздел

• MoveNext()
• Current
• MessageQueueTransactionType