MessageEnumerator.RemoveCurrent MessageEnumerator.RemoveCurrent MessageEnumerator.RemoveCurrent MessageEnumerator.RemoveCurrent Method

Определение

Удаляет текущее сообщение из очереди и возвращает сообщение в вызывающее приложение.Removes the current message from the queue and returns the message to the calling application. При удалении сообщения оно стирается из очереди.Removing the message deletes it from the queue.

Перегрузки

RemoveCurrent() RemoveCurrent() RemoveCurrent() RemoveCurrent()

Удаляет текущее сообщение из транзакционной или нетранзакционной очереди и возвращает сообщение в вызывающее приложение.Removes the current message from a transactional or non-transactional queue and returns the message to the calling application. Не указано время тайм-аута для прибытия сообщения в очередь.There is no timeout specified for a message to arrive in the queue.

RemoveCurrent(MessageQueueTransaction) RemoveCurrent(MessageQueueTransaction) RemoveCurrent(MessageQueueTransaction) RemoveCurrent(MessageQueueTransaction)

Удаляет текущее сообщение из транзакционной очереди и возвращает сообщение в вызывающее приложение.Removes the current message from a transactional queue and returns the message to the calling application. Не указано время тайм-аута для прибытия сообщения в очередь.There is no timeout specified for a message to arrive in the queue.

RemoveCurrent(MessageQueueTransactionType) RemoveCurrent(MessageQueueTransactionType) RemoveCurrent(MessageQueueTransactionType) RemoveCurrent(MessageQueueTransactionType)

Удаляет текущее сообщение из очереди и возвращает сообщение в вызывающее приложение.Removes the current message from a queue and returns the message to the calling application. Не указано время тайм-аута для прибытия сообщения в очередь.There is no timeout specified for a message to arrive in the queue.

RemoveCurrent(TimeSpan) RemoveCurrent(TimeSpan) RemoveCurrent(TimeSpan) RemoveCurrent(TimeSpan)

Удаляет текущее сообщение из очереди и возвращает сообщение в вызывающее приложение.Removes the current message from the queue and returns the message to the calling application. Если имеется сообщение для удаления, этот метод возвращает его немедленно.If there is a message to remove, the method returns it immediately. В противном случае метод ожидает прихода нового сообщения в течение заданного времени тайм-аута.Otherwise, the method waits the specified timeout for a new message to arrive.

RemoveCurrent(TimeSpan, MessageQueueTransaction) RemoveCurrent(TimeSpan, MessageQueueTransaction) RemoveCurrent(TimeSpan, MessageQueueTransaction) RemoveCurrent(TimeSpan, MessageQueueTransaction)

Удаляет текущее сообщение из транзакционной очереди и возвращает сообщение в вызывающее приложение.Removes the current message from a transactional queue and returns the message to the calling application. Если имеется сообщение для удаления, этот метод возвращает его немедленно.If there is a message to remove, the method returns it immediately. В противном случае метод ожидает прихода нового сообщения в течение заданного времени тайм-аута.Otherwise, the method waits the specified timeout for a new message to arrive.

RemoveCurrent(TimeSpan, MessageQueueTransactionType) RemoveCurrent(TimeSpan, MessageQueueTransactionType) RemoveCurrent(TimeSpan, MessageQueueTransactionType) RemoveCurrent(TimeSpan, MessageQueueTransactionType)

Удаляет текущее сообщение из очереди и возвращает сообщение в вызывающее приложение.Removes the current message from a queue and returns the message to the calling application. Если имеется сообщение для удаления, этот метод возвращает его немедленно.If there is a message to remove, the method returns it immediately. В противном случае метод ожидает прихода нового сообщения в течение заданного времени тайм-аута.Otherwise, the method waits the specified timeout for a new message to arrive.

Комментарии

Поведение, описанное для этих перегрузок применима только если MessageEnumerator извлекается экземпляр с помощью GetMessageEnumerator2.The behavior described for these overloads is applicable only if the MessageEnumerator instance is retrieved by using the GetMessageEnumerator2. Не используйте GetMessageEnumerator для получения экземпляра MessageEnumerator как этот метод является устаревшим.Do not use GetMessageEnumerator to retrieve an instance of MessageEnumerator as this method has been deprecated.

RemoveCurrent() RemoveCurrent() RemoveCurrent() RemoveCurrent()

Удаляет текущее сообщение из транзакционной или нетранзакционной очереди и возвращает сообщение в вызывающее приложение.Removes the current message from a transactional or non-transactional queue and returns the message to the calling application. Не указано время тайм-аута для прибытия сообщения в очередь.There is no timeout specified for a message to arrive in the queue.

public:
 System::Messaging::Message ^ RemoveCurrent();
public System.Messaging.Message RemoveCurrent ();
member this.RemoveCurrent : unit -> System.Messaging.Message
Public Function RemoveCurrent () As Message

Возвраты

Объект Message, ссылающийся на первое доступное в очереди сообщение.A Message that references the first message available in the queue.

Комментарии

RemoveCurrent Удаляет и возвращает сообщение в текущем положении курсора.RemoveCurrent removes and returns the message at the cursor's current location.

Если вы используете журнала очереди, удаление сообщения приводит к копии должны храниться в очереди журнала, так же, как MessageQueue класса Receive делает метод.If you are using queue journaling, removing the message causes a copy to be kept in the journal queue, just as the MessageQueue class's Receive method does.

При удалении текущего сообщения, курсор перемещается к следующему сообщению.When you remove the current message, the cursor is moved to the next message. Нет необходимости вызывать MoveNext после вызова метода RemoveCurrent.You do not have to call MoveNext after calling RemoveCurrent.

Если в транзакционной очереди вызывают эту перегрузку, Message Queuing создает один внутреннюю транзакцию.If you call this overload on a transactional queue, Message Queuing creates a single internal transaction.

Дополнительно

RemoveCurrent(MessageQueueTransaction) RemoveCurrent(MessageQueueTransaction) RemoveCurrent(MessageQueueTransaction) RemoveCurrent(MessageQueueTransaction)

Удаляет текущее сообщение из транзакционной очереди и возвращает сообщение в вызывающее приложение.Removes the current message from a transactional queue and returns the message to the calling application. Не указано время тайм-аута для прибытия сообщения в очередь.There is no timeout specified for a message to arrive in the queue.

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 MessageQueueTransaction MessageQueueTransaction

Объект MessageQueueTransaction, задающий транзакцию, в которой будет удалено сообщение.The MessageQueueTransaction object that specifies the transaction in which the message will be removed.

Возвраты

Объект Message, ссылающийся на первое доступное в очереди сообщение.A Message that references the first message available in the queue.

Исключения

Параметр transaction имеет значение null.The transaction parameter is null.

Комментарии

RemoveCurrent Удаляет и возвращает сообщение в текущем положении курсора, используя контекст внутренней транзакции, определяемый параметром transaction параметр.RemoveCurrent removes and returns the message at the cursor's current location, using the internal transaction context defined by the transaction parameter.

Если вы используете журнала очереди, удаление сообщения приводит к копии должны храниться в очереди журнала, так же, как MessageQueue класса Receive делает метод.If you are using queue journaling, removing the message causes a copy to be kept in the journal queue, just as the MessageQueue class's Receive method does.

При работе с очереди транзакций, откат транзакции вызывает любые сообщения, удаленные с помощью вызова RemoveCurrent возвращается в очередь.When working with transactional queues, a rollback of a transaction causes any messages removed by a call to RemoveCurrent to be returned to the queue. Удаление не является необратимым, пока транзакция фиксируется.The removal is not irreversible until the transaction is committed.

При удалении текущего сообщения, курсор перемещается к следующему сообщению.When you remove the current message, the cursor is moved to the next message. Нет необходимости вызывать MoveNext после вызова метода RemoveCurrent.You do not have to call MoveNext after calling RemoveCurrent.

Дополнительно

RemoveCurrent(MessageQueueTransactionType) RemoveCurrent(MessageQueueTransactionType) RemoveCurrent(MessageQueueTransactionType) RemoveCurrent(MessageQueueTransactionType)

Удаляет текущее сообщение из очереди и возвращает сообщение в вызывающее приложение.Removes the current message from a queue and returns the message to the calling application. Не указано время тайм-аута для прибытия сообщения в очередь.There is no timeout specified for a message to arrive in the queue.

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 MessageQueueTransactionType MessageQueueTransactionType

Одно из значений MessageQueueTransactionType, описывающее тип контекста транзакции, связываемого с сообщением.One of the MessageQueueTransactionType values, describing the type of transaction context to associate with the message.

Возвраты

Объект Message, ссылающийся на первое доступное в очереди сообщение.A Message that references the first message available in the queue.

Исключения

Параметр transactionType не является одним из членов MessageQueueTransactionType.The transactionType parameter is not one of the MessageQueueTransactionType members.

Комментарии

RemoveCurrent Удаляет и возвращает сообщение в текущем положении курсора, используя контекст транзакции, определяемый параметром transactionType параметр.RemoveCurrent removes and returns the message at the cursor's current location, using a transaction context defined by the transactionType parameter.

Укажите Automatic для transactionType параметра, если уже имеется контекст внешней транзакции, присоединенный к потоку, который вы хотите использовать для получения сообщения.Specify Automatic for the transactionType parameter if there is already an external transaction context attached to the thread that you want to use to receive the message. Укажите Single Если вы хотите получать сообщения в виде единой внутренней транзакции.Specify Single if you want to receive the message as a single internal transaction. Можно указать None Если вы хотите получить сообщение из транзакционной очереди вне контекста транзакции.You can specify None if you want to receive a message from a transactional queue outside of a transaction context.

Если вы используете журнала очереди, удаление сообщения приводит к копии должны храниться в очереди журнала, так же, как MessageQueue класса Receive делает метод.If you are using queue journaling, removing the message causes a copy to be kept in the journal queue, just as the MessageQueue class's Receive method does.

При работе с очереди транзакций, откат транзакции вызывает любые сообщения, удаленные с помощью вызова RemoveCurrent возвращается в очередь.When working with transactional queues, a rollback of a transaction causes any messages removed by a call to RemoveCurrent to be returned to the queue. Удаление не является необратимым, пока транзакция фиксируется.The removal is not irreversible until the transaction is committed.

При удалении текущего сообщения, курсор перемещается к следующему сообщению.When you remove the current message, the cursor is moved to the next message. Нет необходимости вызывать MoveNext после вызова метода RemoveCurrent.You do not have to call MoveNext after calling RemoveCurrent.

Дополнительно

RemoveCurrent(TimeSpan) RemoveCurrent(TimeSpan) RemoveCurrent(TimeSpan) RemoveCurrent(TimeSpan)

Удаляет текущее сообщение из очереди и возвращает сообщение в вызывающее приложение.Removes the current message from the queue and returns the message to the calling application. Если имеется сообщение для удаления, этот метод возвращает его немедленно.If there is a message to remove, the method returns it immediately. В противном случае метод ожидает прихода нового сообщения в течение заданного времени тайм-аута.Otherwise, the method waits the specified timeout for a new message to arrive.

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 TimeSpan TimeSpan TimeSpan

Интервал времени ожидания прихода сообщения в очередь.The interval of time to wait for a message to arrive in the queue.

Возвраты

Объект Message, ссылающийся на первое доступное в очереди сообщение.A Message that references the first message available in the queue.

Исключения

Для параметра timeout задано недопустимое значение.The value specified for the timeout parameter is invalid.

Истекло время тайм-аута.The timeout has expired.

Комментарии

RemoveCurrent Удаляет и возвращает сообщение в текущем положении курсора.RemoveCurrent removes and returns the message at the cursor's current location. Если курсор находится в конце очереди, эта перегрузка метода ожидает, пока сообщение не станет доступным или время, заданное параметром timeout истечет.If the cursor is at the end of the queue, this overload of the method waits until a message is available or the interval specified by the timeout parameter has expired.

Если вы используете журнала очереди, удаление сообщения приводит к копии должны храниться в очереди журнала, так же, как MessageQueue класса Receive делает метод.If you are using queue journaling, removing the message causes a copy to be kept in the journal queue, just as the MessageQueue class's Receive method does.

При удалении текущего сообщения, курсор перемещается к следующему сообщению.When you remove the current message, the cursor is moved to the next message. Нет необходимости вызывать MoveNext после вызова метода RemoveCurrent.You do not have to call MoveNext after calling RemoveCurrent.

Если в транзакционной очереди вызывают эту перегрузку, Message Queuing создает один внутреннюю транзакцию.If you call this overload on a transactional queue, Message Queuing creates a single internal transaction.

Дополнительно

RemoveCurrent(TimeSpan, MessageQueueTransaction) RemoveCurrent(TimeSpan, MessageQueueTransaction) RemoveCurrent(TimeSpan, MessageQueueTransaction) RemoveCurrent(TimeSpan, MessageQueueTransaction)

Удаляет текущее сообщение из транзакционной очереди и возвращает сообщение в вызывающее приложение.Removes the current message from a transactional queue and returns the message to the calling application. Если имеется сообщение для удаления, этот метод возвращает его немедленно.If there is a message to remove, the method returns it immediately. В противном случае метод ожидает прихода нового сообщения в течение заданного времени тайм-аута.Otherwise, the method waits the specified timeout for a new message to arrive.

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 TimeSpan TimeSpan TimeSpan

Интервал времени ожидания удаления сообщения.The interval of time to wait for the message to be removed.

transaction
MessageQueueTransaction MessageQueueTransaction MessageQueueTransaction MessageQueueTransaction

Объект MessageQueueTransaction, задающий контекст транзакции для сообщения.The MessageQueueTransaction object that specifies the transaction context for the message.

Возвраты

Объект Message, ссылающийся на первое доступное в очереди сообщение.A Message that references the first message available in the queue.

Исключения

Для параметра timeout задано недопустимое значение.The value specified for the timeout parameter is invalid.

Параметр transaction имеет значение null.The transaction parameter is null.

Истекло время тайм-аута.The timeout has expired.

Комментарии

RemoveCurrent Удаляет и возвращает сообщение в текущем положении курсора.RemoveCurrent removes and returns the message at the cursor's current location. Если курсор находится в конце очереди, эта перегрузка метода ожидает, пока сообщение не станет доступным или время, заданное параметром timeout истечет.If the cursor is at the end of the queue, this overload of the method waits until a message is available or the interval specified by the timeout parameter has expired.

При работе с очереди транзакций, откат транзакции вызывает любые сообщения, удаленные с помощью вызова RemoveCurrent возвращается в очередь.When working with transactional queues, a rollback of a transaction causes any messages removed by a call to RemoveCurrent to be returned to the queue. Удаление не является необратимым, пока транзакция фиксируется.The removal is not irreversible until the transaction is committed.

Если вы используете журнала очереди, удаление сообщения приводит к копии должны храниться в очереди журнала, так же, как MessageQueue класса Receive делает метод.If you are using queue journaling, removing the message causes a copy to be kept in the journal queue, just as the MessageQueue class's Receive method does.

При удалении текущего сообщения, курсор перемещается к следующему сообщению.When you remove the current message, the cursor is moved to the next message. Нет необходимости вызывать MoveNext после вызова метода RemoveCurrent.You do not have to call MoveNext after calling RemoveCurrent.

Дополнительно

RemoveCurrent(TimeSpan, MessageQueueTransactionType) RemoveCurrent(TimeSpan, MessageQueueTransactionType) RemoveCurrent(TimeSpan, MessageQueueTransactionType) RemoveCurrent(TimeSpan, MessageQueueTransactionType)

Удаляет текущее сообщение из очереди и возвращает сообщение в вызывающее приложение.Removes the current message from a queue and returns the message to the calling application. Если имеется сообщение для удаления, этот метод возвращает его немедленно.If there is a message to remove, the method returns it immediately. В противном случае метод ожидает прихода нового сообщения в течение заданного времени тайм-аута.Otherwise, the method waits the specified timeout for a new message to arrive.

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 TimeSpan TimeSpan TimeSpan

Интервал времени ожидания удаления сообщения.The interval of time to wait for the message to be removed.

transactionType
MessageQueueTransactionType MessageQueueTransactionType MessageQueueTransactionType MessageQueueTransactionType

Одно из значений MessageQueueTransactionType, описывающее тип контекста транзакции, связываемого с сообщением.One of the MessageQueueTransactionType values, describing the type of transaction context to associate with the message.

Возвраты

Объект Message, ссылающийся на первое доступное в очереди сообщение.A Message that references the first message available in the queue.

Исключения

Для параметра timeout задано недопустимое значение.The value specified for the timeout parameter is invalid.

Истекло время тайм-аута.The timeout has expired.

Параметр transactionType не является одним из членов MessageQueueTransactionType.The transactionType parameter is not one of the MessageQueueTransactionType members.

Комментарии

RemoveCurrent Удаляет и возвращает сообщение в текущем положении курсора, используя контекст транзакции, определяемый параметром transactionType параметр.RemoveCurrent removes and returns the message at the cursor's current location, using a transaction context defined by the transactionType parameter. Если курсор находится в конце очереди, эта перегрузка метода ожидает, пока сообщение не станет доступным или время, заданное параметром timeout истечет.If the cursor is at the end of the queue, this overload of the method waits until a message is available or the interval specified by the timeout parameter has expired.

Укажите Automatic для transactionType параметра, если уже имеется контекст внешней транзакции, присоединенный к потоку, который вы хотите использовать для получения сообщения.Specify Automatic for the transactionType parameter if there is already an external transaction context attached to the thread that you want to use to receive the message. Укажите Single Если вы хотите получать сообщения в виде единой внутренней транзакции.Specify Single if you want to receive the message as a single internal transaction. Можно указать None Если вы хотите получить сообщение из транзакционной очереди вне контекста транзакции.You can specify None if you want to receive a message from a transactional queue outside of a transaction context.

Если вы используете журнала очереди, удаление сообщения приводит к копии должны храниться в очереди журнала, так же, как MessageQueue класса Receive делает метод.If you are using queue journaling, removing the message causes a copy to be kept in the journal queue, just as the MessageQueue class's Receive method does.

При работе с очереди транзакций, откат транзакции вызывает любые сообщения, удаленные с помощью вызова RemoveCurrent возвращается в очередь.When working with transactional queues, a rollback of a transaction causes any messages removed by a call to RemoveCurrent to be returned to the queue. Удаление не является необратимым, пока транзакция фиксируется.The removal is not irreversible until the transaction is committed.

При удалении текущего сообщения, курсор перемещается к следующему сообщению.When you remove the current message, the cursor is moved to the next message. Нет необходимости вызывать MoveNext после вызова метода RemoveCurrent.You do not have to call MoveNext after calling RemoveCurrent.

Дополнительно

Применяется к