MessageEnumerator.RemoveCurrent Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.MessagePublic Function RemoveCurrent () As MessageDevoluciones
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.MessagePublic Function RemoveCurrent (transaction As MessageQueueTransaction) As MessagePará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.MessagePublic Function RemoveCurrent (transactionType As MessageQueueTransactionType) As MessagePará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.MessagePublic Function RemoveCurrent (timeout As TimeSpan) As MessagePará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.MessagePublic Function RemoveCurrent (timeout As TimeSpan, transaction As MessageQueueTransaction) As MessagePará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.MessagePublic Function RemoveCurrent (timeout As TimeSpan, transactionType As MessageQueueTransactionType) As MessagePará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
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de