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

Definición

Quita el mensaje actual de la cola y lo devuelve a la aplicación que realiza la llamada.Removes the current message from the queue and returns the message to the calling application. Al quitar el mensaje, éste se elimina de la cola.Removing the message deletes it from the queue.

Sobrecargas

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

Quita el mensaje actual de una cola transaccional o no transaccional y lo devuelve a la aplicación que realiza la llamada.Removes the current message from a transactional or non-transactional queue and returns the message to the calling application. No hay un tiempo de espera determinado para que un mensaje llegue a la cola.There is no timeout specified for a message to arrive in the queue.

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

Quita el mensaje actual de una cola transaccional y devuelve el mensaje a la aplicación que realiza la llamada.Removes the current message from a transactional queue and returns the message to the calling application. No hay un tiempo de espera determinado para que un mensaje llegue a la cola.There is no timeout specified for a message to arrive in the queue.

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

Quita el mensaje actual de una cola y lo devuelve a la aplicación que realiza la llamada.Removes the current message from a queue and returns the message to the calling application. No hay un tiempo de espera determinado para que un mensaje llegue a la cola.There is no timeout specified for a message to arrive in the queue.

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

Quita el mensaje actual de la cola y lo devuelve a la aplicación que realiza la llamada.Removes the current message from the queue and returns the message to the calling application. Si hay un mensaje que quitar, el método lo devuelve inmediatamente.If there is a message to remove, the method returns it immediately. En caso contrario, el método espera el tiempo de espera especificado hasta que llegue un mensaje nuevo.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)

Quita el mensaje actual de una cola transaccional y devuelve el mensaje a la aplicación que realiza la llamada.Removes the current message from a transactional queue and returns the message to the calling application. Si hay un mensaje que quitar, el método lo devuelve inmediatamente.If there is a message to remove, the method returns it immediately. En caso contrario, el método espera el tiempo de espera especificado hasta que llegue un mensaje nuevo.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)

Quita el mensaje actual de una cola y lo devuelve a la aplicación que realiza la llamada.Removes the current message from a queue and returns the message to the calling application. Si hay un mensaje que quitar, el método lo devuelve inmediatamente.If there is a message to remove, the method returns it immediately. En caso contrario, el método espera el tiempo de espera especificado hasta que llegue un mensaje nuevo.Otherwise, the method waits the specified timeout for a new message to arrive.

Comentarios

El comportamiento descrito para estas sobrecargas solo es aplicable si la MessageEnumerator instancia se recupera GetMessageEnumerator2mediante.The behavior described for these overloads is applicable only if the MessageEnumerator instance is retrieved by using the GetMessageEnumerator2. No use GetMessageEnumerator para recuperar una instancia de MessageEnumerator , ya que este método está en desuso.Do not use GetMessageEnumerator to retrieve an instance of MessageEnumerator as this method has been deprecated.

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

Quita el mensaje actual de una cola transaccional o no transaccional y lo devuelve a la aplicación que realiza la llamada.Removes the current message from a transactional or non-transactional queue and returns the message to the calling application. No hay un tiempo de espera determinado para que un mensaje llegue a la cola.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

Devoluciones

Message que hace referencia al primer mensaje disponible en la cola.A Message that references the first message available in the queue.

Comentarios

RemoveCurrentquita y devuelve el mensaje en la ubicación actual del cursor.RemoveCurrent removes and returns the message at the cursor's current location.

Si utiliza el diario de cola, al quitar el mensaje se mantiene una copia en la cola del diario, de la misma forma MessageQueue que el Receive método de la clase.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.

Cuando se quita el mensaje actual, el cursor se mueve al siguiente mensaje.When you remove the current message, the cursor is moved to the next message. No es necesario llamar MoveNext a después de llamar a. RemoveCurrentYou do not have to call MoveNext after calling RemoveCurrent.

Si se llama a esta sobrecarga en una cola transaccional, Message Queue Server crea una única transacción interna.If you call this overload on a transactional queue, Message Queuing creates a single internal transaction.

Consulte también:

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

Quita el mensaje actual de una cola transaccional y devuelve el mensaje a la aplicación que realiza la llamada.Removes the current message from a transactional queue and returns the message to the calling application. No hay un tiempo de espera determinado para que un mensaje llegue a la cola.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

Parámetros

transaction
MessageQueueTransaction MessageQueueTransaction MessageQueueTransaction MessageQueueTransaction

Objeto MessageQueueTransaction que especifica la transacción de la que se quitará el mensaje.The MessageQueueTransaction object that specifies the transaction in which the message will be removed.

Devoluciones

Message que hace referencia al primer mensaje disponible en la cola.A Message that references the first message available in the queue.

Excepciones

El parámetro transaction es null.The transaction parameter is null.

Comentarios

RemoveCurrentquita y devuelve el mensaje en la ubicación actual del cursor, utilizando el contexto de transacción interno definido por transaction el parámetro.RemoveCurrent removes and returns the message at the cursor's current location, using the internal transaction context defined by the transaction parameter.

Si utiliza el diario de cola, al quitar el mensaje se mantiene una copia en la cola del diario, de la misma forma MessageQueue que el Receive método de la clase.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.

Al trabajar con colas transaccionales, una reversión de una transacción hace que todos los mensajes quitados por RemoveCurrent una llamada a se devuelvan a la cola.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. La eliminación no es irreversible hasta que se confirma la transacción.The removal is not irreversible until the transaction is committed.

Cuando se quita el mensaje actual, el cursor se mueve al siguiente mensaje.When you remove the current message, the cursor is moved to the next message. No es necesario llamar MoveNext a después de llamar a. RemoveCurrentYou do not have to call MoveNext after calling RemoveCurrent.

Consulte también:

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

Quita el mensaje actual de una cola y lo devuelve a la aplicación que realiza la llamada.Removes the current message from a queue and returns the message to the calling application. No hay un tiempo de espera determinado para que un mensaje llegue a la cola.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

Parámetros

transactionType
MessageQueueTransactionType MessageQueueTransactionType MessageQueueTransactionType MessageQueueTransactionType

Uno de los valores de MessageQueueTransactionType, que describe el tipo de contexto de transacción que se va a asociar al mensaje.One of the MessageQueueTransactionType values, describing the type of transaction context to associate with the message.

Devoluciones

Message que hace referencia al primer mensaje disponible en la cola.A Message that references the first message available in the queue.

Excepciones

El parámetro transactionType no es un miembro de MessageQueueTransactionType.The transactionType parameter is not one of the MessageQueueTransactionType members.

Comentarios

RemoveCurrentquita y devuelve el mensaje en la ubicación actual del cursor, utilizando un contexto de transacción definido por transactionType el parámetro.RemoveCurrent removes and returns the message at the cursor's current location, using a transaction context defined by the transactionType parameter.

Especifique Automatic para el transactionType parámetro si ya existe un contexto de transacción externa asociado al subproceso que desea usar para recibir el mensaje.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. Especifique Single si desea recibir el mensaje como una sola transacción interna.Specify Single if you want to receive the message as a single internal transaction. Puede especificar None si desea recibir un mensaje de una cola transaccional fuera de un contexto de transacción.You can specify None if you want to receive a message from a transactional queue outside of a transaction context.

Si utiliza el diario de cola, al quitar el mensaje se mantiene una copia en la cola del diario, de la misma forma MessageQueue que el Receive método de la clase.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.

Al trabajar con colas transaccionales, una reversión de una transacción hace que todos los mensajes quitados por RemoveCurrent una llamada a se devuelvan a la cola.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. La eliminación no es irreversible hasta que se confirma la transacción.The removal is not irreversible until the transaction is committed.

Cuando se quita el mensaje actual, el cursor se mueve al siguiente mensaje.When you remove the current message, the cursor is moved to the next message. No es necesario llamar MoveNext a después de llamar a. RemoveCurrentYou do not have to call MoveNext after calling RemoveCurrent.

Consulte también:

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

Quita el mensaje actual de la cola y lo devuelve a la aplicación que realiza la llamada.Removes the current message from the queue and returns the message to the calling application. Si hay un mensaje que quitar, el método lo devuelve inmediatamente.If there is a message to remove, the method returns it immediately. En caso contrario, el método espera el tiempo de espera especificado hasta que llegue un mensaje nuevo.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

Parámetros

timeout
TimeSpan TimeSpan TimeSpan TimeSpan

Intervalo de tiempo que hay que esperar a que un mensaje llegue a la cola.The interval of time to wait for a message to arrive in the queue.

Devoluciones

Message que hace referencia al primer mensaje disponible en la cola.A Message that references the first message available in the queue.

Excepciones

El valor especificado para el parámetro timeout no es válido.The value specified for the timeout parameter is invalid.

El tiempo de espera ha expirado.The timeout has expired.

Comentarios

RemoveCurrentquita y devuelve el mensaje en la ubicación actual del cursor.RemoveCurrent removes and returns the message at the cursor's current location. Si el cursor está al final de la cola, esta sobrecarga del método espera hasta que haya un mensaje disponible o hasta que el intervalo especificado por el timeout parámetro ha expirado.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.

Si utiliza el diario de cola, al quitar el mensaje se mantiene una copia en la cola del diario, de la misma forma MessageQueue que el Receive método de la clase.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.

Cuando se quita el mensaje actual, el cursor se mueve al siguiente mensaje.When you remove the current message, the cursor is moved to the next message. No es necesario llamar MoveNext a después de llamar a. RemoveCurrentYou do not have to call MoveNext after calling RemoveCurrent.

Si se llama a esta sobrecarga en una cola transaccional, Message Queue Server crea una única transacción interna.If you call this overload on a transactional queue, Message Queuing creates a single internal transaction.

Consulte también:

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

Quita el mensaje actual de una cola transaccional y devuelve el mensaje a la aplicación que realiza la llamada.Removes the current message from a transactional queue and returns the message to the calling application. Si hay un mensaje que quitar, el método lo devuelve inmediatamente.If there is a message to remove, the method returns it immediately. En caso contrario, el método espera el tiempo de espera especificado hasta que llegue un mensaje nuevo.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

Parámetros

timeout
TimeSpan TimeSpan TimeSpan TimeSpan

Intervalo de tiempo que hay que esperar hasta que se quite el mensaje.The interval of time to wait for the message to be removed.

transaction
MessageQueueTransaction MessageQueueTransaction MessageQueueTransaction MessageQueueTransaction

Objeto MessageQueueTransaction que especifica el contexto de transacción para el mensaje.The MessageQueueTransaction object that specifies the transaction context for the message.

Devoluciones

Message que hace referencia al primer mensaje disponible en la cola.A Message that references the first message available in the queue.

Excepciones

El valor especificado para el parámetro timeout no es válido.The value specified for the timeout parameter is invalid.

El parámetro transaction es null.The transaction parameter is null.

El tiempo de espera ha expirado.The timeout has expired.

Comentarios

RemoveCurrentquita y devuelve el mensaje en la ubicación actual del cursor.RemoveCurrent removes and returns the message at the cursor's current location. Si el cursor está al final de la cola, esta sobrecarga del método espera hasta que haya un mensaje disponible o hasta que el intervalo especificado por el timeout parámetro ha expirado.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.

Al trabajar con colas transaccionales, una reversión de una transacción hace que todos los mensajes quitados por RemoveCurrent una llamada a se devuelvan a la cola.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. La eliminación no es irreversible hasta que se confirma la transacción.The removal is not irreversible until the transaction is committed.

Si utiliza el diario de cola, al quitar el mensaje se mantiene una copia en la cola del diario, de la misma forma MessageQueue que el Receive método de la clase.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.

Cuando se quita el mensaje actual, el cursor se mueve al siguiente mensaje.When you remove the current message, the cursor is moved to the next message. No es necesario llamar MoveNext a después de llamar a. RemoveCurrentYou do not have to call MoveNext after calling RemoveCurrent.

Consulte también:

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

Quita el mensaje actual de una cola y lo devuelve a la aplicación que realiza la llamada.Removes the current message from a queue and returns the message to the calling application. Si hay un mensaje que quitar, el método lo devuelve inmediatamente.If there is a message to remove, the method returns it immediately. En caso contrario, el método espera el tiempo de espera especificado hasta que llegue un mensaje nuevo.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

Parámetros

timeout
TimeSpan TimeSpan TimeSpan TimeSpan

Intervalo de tiempo que hay que esperar hasta que se quite el mensaje.The interval of time to wait for the message to be removed.

transactionType
MessageQueueTransactionType MessageQueueTransactionType MessageQueueTransactionType MessageQueueTransactionType

Uno de los valores de MessageQueueTransactionType, que describe el tipo de contexto de transacción que se va a asociar al mensaje.One of the MessageQueueTransactionType values, describing the type of transaction context to associate with the message.

Devoluciones

Message que hace referencia al primer mensaje disponible en la cola.A Message that references the first message available in the queue.

Excepciones

El valor especificado para el parámetro timeout no es válido.The value specified for the timeout parameter is invalid.

El tiempo de espera ha expirado.The timeout has expired.

El parámetro transactionType no es un miembro de MessageQueueTransactionType.The transactionType parameter is not one of the MessageQueueTransactionType members.

Comentarios

RemoveCurrentquita y devuelve el mensaje en la ubicación actual del cursor, utilizando un contexto de transacción definido por transactionType el parámetro.RemoveCurrent removes and returns the message at the cursor's current location, using a transaction context defined by the transactionType parameter. Si el cursor está al final de la cola, esta sobrecarga del método espera hasta que haya un mensaje disponible o hasta que el intervalo especificado por el timeout parámetro ha expirado.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.

Especifique Automatic para el transactionType parámetro si ya existe un contexto de transacción externa asociado al subproceso que desea usar para recibir el mensaje.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. Especifique Single si desea recibir el mensaje como una sola transacción interna.Specify Single if you want to receive the message as a single internal transaction. Puede especificar None si desea recibir un mensaje de una cola transaccional fuera de un contexto de transacción.You can specify None if you want to receive a message from a transactional queue outside of a transaction context.

Si utiliza el diario de cola, al quitar el mensaje se mantiene una copia en la cola del diario, de la misma forma MessageQueue que el Receive método de la clase.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.

Al trabajar con colas transaccionales, una reversión de una transacción hace que todos los mensajes quitados por RemoveCurrent una llamada a se devuelvan a la cola.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. La eliminación no es irreversible hasta que se confirma la transacción.The removal is not irreversible until the transaction is committed.

Cuando se quita el mensaje actual, el cursor se mueve al siguiente mensaje.When you remove the current message, the cursor is moved to the next message. No es necesario llamar MoveNext a después de llamar a. RemoveCurrentYou do not have to call MoveNext after calling RemoveCurrent.

Consulte también:

Se aplica a