Compartir a través de


MessageEnumerator.RemoveCurrent Método

Definición

Quita el mensaje actual de la cola y lo devuelve a la aplicación que realiza la llamada. Al quitar el mensaje, éste se elimina de la cola.

Sobrecargas

RemoveCurrent()

Quita el mensaje actual de una cola transaccional o no transaccional y lo devuelve a la aplicación que realiza la llamada. No hay un tiempo de espera determinado para que un mensaje llegue a la cola.

RemoveCurrent(MessageQueueTransaction)

Quita el mensaje actual de una cola transaccional y devuelve el mensaje a la aplicación que realiza la llamada. No hay un tiempo de espera determinado para que un mensaje llegue a la cola.

RemoveCurrent(MessageQueueTransactionType)

Quita el mensaje actual de una cola y lo devuelve a la aplicación que realiza la llamada. No hay un tiempo de espera determinado para que un mensaje llegue a la cola.

RemoveCurrent(TimeSpan)

Quita el mensaje actual de la cola y lo devuelve a la aplicación que realiza la llamada. Si hay un mensaje que quitar, el método lo devuelve inmediatamente. En caso contrario, el método espera el tiempo de espera especificado hasta que llegue un mensaje nuevo.

RemoveCurrent(TimeSpan, MessageQueueTransaction)

Quita el mensaje actual de una cola transaccional y devuelve el mensaje a la aplicación que realiza la llamada. Si hay un mensaje que quitar, el método lo devuelve inmediatamente. En caso contrario, el método espera el tiempo de espera especificado hasta que llegue un mensaje nuevo.

RemoveCurrent(TimeSpan, MessageQueueTransactionType)

Quita el mensaje actual de una cola y lo devuelve a la aplicación que realiza la llamada. Si hay un mensaje que quitar, el método lo devuelve inmediatamente. En caso contrario, el método espera el tiempo de espera especificado hasta que llegue un mensaje nuevo.

Comentarios

El comportamiento descrito para estas sobrecargas solo es aplicable si la MessageEnumerator instancia se recupera mediante .GetMessageEnumerator2 No use GetMessageEnumerator para recuperar una instancia de , MessageEnumerator ya que este método ha quedado en desuso.

RemoveCurrent()

Quita el mensaje actual de una cola transaccional o no transaccional y lo devuelve a la aplicación que realiza la llamada. No hay un tiempo de espera determinado para que un mensaje llegue a la cola.

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.

Comentarios

RemoveCurrent quita y devuelve el mensaje en la ubicación actual del cursor.

Si usa el registro en diario de cola, quitar el mensaje hace que se mantenga una copia en la cola del diario, igual que lo hace el método de Receive la MessageQueue clase.

Al quitar el mensaje actual, el cursor se mueve al siguiente mensaje. No es necesario llamar MoveNext a después de llamar a RemoveCurrent.

Si llama a esta sobrecarga en una cola transaccional, Message Queuing crea una única transacción interna.

Consulte también

Se aplica a

RemoveCurrent(MessageQueueTransaction)

Quita el mensaje actual de una cola transaccional y devuelve el mensaje a la aplicación que realiza la llamada. No hay un tiempo de espera determinado para que un mensaje llegue a la cola.

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

Objeto MessageQueueTransaction que especifica la transacción de la que se quitará el mensaje.

Devoluciones

Message que hace referencia al primer mensaje disponible en la cola.

Excepciones

El parámetro transaction es null.

Comentarios

RemoveCurrent quita y devuelve el mensaje en la ubicación actual del cursor, utilizando el contexto de transacción interno definido por el transaction parámetro .

Si usa el registro en diario de cola, quitar el mensaje hace que se mantenga una copia en la cola del diario, igual que lo hace el método de Receive la MessageQueue clase.

Cuando se trabaja con colas transaccionales, una reversión de una transacción hace que los mensajes eliminados por una llamada se devuelvan RemoveCurrent a la cola. La eliminación no es irreversible hasta que se confirma la transacción.

Al quitar el mensaje actual, el cursor se mueve al siguiente mensaje. No es necesario llamar MoveNext a después de llamar a RemoveCurrent.

Consulte también

Se aplica a

RemoveCurrent(MessageQueueTransactionType)

Quita el mensaje actual de una cola y lo devuelve a la aplicación que realiza la llamada. No hay un tiempo de espera determinado para que un mensaje llegue a la cola.

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

Uno de los valores de MessageQueueTransactionType, que describe el tipo de contexto de transacción que se va a asociar al mensaje.

Devoluciones

Message que hace referencia al primer mensaje disponible en la cola.

Excepciones

El parámetro transactionType no es un miembro de MessageQueueTransactionType.

Comentarios

RemoveCurrent quita y devuelve el mensaje en la ubicación actual del cursor mediante un contexto de transacción definido por el transactionType parámetro .

Especifique Automatic para el transactionType parámetro si ya hay un contexto de transacción externo asociado al subproceso que desea usar para recibir el mensaje. Especifique Single si desea recibir el mensaje como una única transacción interna. Puede especificar None si desea recibir un mensaje de una cola transaccional fuera de un contexto de transacción.

Si usa el registro en diario de cola, quitar el mensaje hace que se mantenga una copia en la cola del diario, igual que lo hace el método de Receive la MessageQueue clase.

Cuando se trabaja con colas transaccionales, una reversión de una transacción hace que los mensajes eliminados por una llamada se devuelvan RemoveCurrent a la cola. La eliminación no es irreversible hasta que se confirma la transacción.

Al quitar el mensaje actual, el cursor se mueve al siguiente mensaje. No es necesario llamar MoveNext a después de llamar a RemoveCurrent.

Consulte también

Se aplica a

RemoveCurrent(TimeSpan)

Quita el mensaje actual de la cola y lo devuelve a la aplicación que realiza la llamada. Si hay un mensaje que quitar, el método lo devuelve inmediatamente. En caso contrario, el método espera el tiempo de espera especificado hasta que llegue un mensaje nuevo.

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

Intervalo de tiempo que hay que esperar a que un mensaje llegue a la cola.

Devoluciones

Message que hace referencia al primer mensaje disponible en la cola.

Excepciones

El valor especificado para el parámetro timeout no es válido.

El tiempo de espera ha expirado.

Comentarios

RemoveCurrent quita y devuelve el mensaje en la ubicación actual del cursor. Si el cursor está al final de la cola, esta sobrecarga del método espera hasta que un mensaje esté disponible o el intervalo especificado por el timeout parámetro haya expirado.

Si usa el registro en diario de cola, quitar el mensaje hace que se mantenga una copia en la cola del diario, igual que lo hace el método de Receive la MessageQueue clase.

Al quitar el mensaje actual, el cursor se mueve al siguiente mensaje. No es necesario llamar MoveNext a después de llamar a RemoveCurrent.

Si llama a esta sobrecarga en una cola transaccional, Message Queuing crea una única transacción interna.

Consulte también

Se aplica a

RemoveCurrent(TimeSpan, MessageQueueTransaction)

Quita el mensaje actual de una cola transaccional y devuelve el mensaje a la aplicación que realiza la llamada. Si hay un mensaje que quitar, el método lo devuelve inmediatamente. En caso contrario, el método espera el tiempo de espera especificado hasta que llegue un mensaje nuevo.

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

Intervalo de tiempo que hay que esperar hasta que se quite el mensaje.

transaction
MessageQueueTransaction

Objeto MessageQueueTransaction que especifica el contexto de transacción para el mensaje.

Devoluciones

Message que hace referencia al primer mensaje disponible en la cola.

Excepciones

El valor especificado para el parámetro timeout no es válido.

El parámetro transaction es null.

El tiempo de espera ha expirado.

Comentarios

RemoveCurrent quita y devuelve el mensaje en la ubicación actual del cursor. Si el cursor está al final de la cola, esta sobrecarga del método espera hasta que un mensaje esté disponible o el intervalo especificado por el timeout parámetro haya expirado.

Cuando se trabaja con colas transaccionales, una reversión de una transacción hace que los mensajes eliminados por una llamada se devuelvan RemoveCurrent a la cola. La eliminación no es irreversible hasta que se confirma la transacción.

Si usa el registro en diario de cola, quitar el mensaje hace que se mantenga una copia en la cola del diario, igual que lo hace el método de Receive la MessageQueue clase.

Al quitar el mensaje actual, el cursor se mueve al siguiente mensaje. No es necesario llamar MoveNext a después de llamar a RemoveCurrent.

Consulte también

Se aplica a

RemoveCurrent(TimeSpan, MessageQueueTransactionType)

Quita el mensaje actual de una cola y lo devuelve a la aplicación que realiza la llamada. Si hay un mensaje que quitar, el método lo devuelve inmediatamente. En caso contrario, el método espera el tiempo de espera especificado hasta que llegue un mensaje nuevo.

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

Intervalo de tiempo que hay que esperar hasta que se quite el mensaje.

transactionType
MessageQueueTransactionType

Uno de los valores de MessageQueueTransactionType, que describe el tipo de contexto de transacción que se va a asociar al mensaje.

Devoluciones

Message que hace referencia al primer mensaje disponible en la cola.

Excepciones

El valor especificado para el parámetro timeout no es válido.

El tiempo de espera ha expirado.

El parámetro transactionType no es un miembro de MessageQueueTransactionType.

Comentarios

RemoveCurrent quita y devuelve el mensaje en la ubicación actual del cursor, utilizando un contexto de transacción definido por el transactionType parámetro . Si el cursor está al final de la cola, esta sobrecarga del método espera hasta que haya un mensaje disponible o el intervalo especificado por el timeout parámetro haya expirado.

Especifique Automatic para el transactionType parámetro si ya hay un contexto de transacción externo asociado al subproceso que desea usar para recibir el mensaje. Especifique Single si desea recibir el mensaje como una única transacción interna. Puede especificar None si desea recibir un mensaje de una cola transaccional fuera de un contexto de transacción.

Si usa el registro en diario de colas, quitar el mensaje hace que se mantenga una copia en la cola del diario, tal como hace el método de Receive la MessageQueue clase.

Cuando se trabaja con colas transaccionales, una reversión de una transacción hace que los mensajes quitados por una llamada se devuelvan RemoveCurrent a la cola. La eliminación no es irreversible hasta que se confirma la transacción.

Al quitar el mensaje actual, el cursor se mueve al siguiente mensaje. No es necesario llamar MoveNext a después de llamar a RemoveCurrent.

Consulte también

Se aplica a