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

Definizione

Rimuove il messaggio corrente dalla coda e restituisce il messaggio all'applicazione che ha eseguito la chiamata.Removes the current message from the queue and returns the message to the calling application. La rimozione del messaggio determina la sua eliminazione dalla coda.Removing the message deletes it from the queue.

Overload

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

Rimuove il messaggio corrente da una coda transazionale o non transazionale e restituisce il messaggio all'applicazione che ha eseguito la chiamata.Removes the current message from a transactional or non-transactional queue and returns the message to the calling application. Non esistono timeout specifici per l'arrivo di un messaggio nella coda.There is no timeout specified for a message to arrive in the queue.

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

Rimuove il messaggio corrente da una coda transazionale e restituisce il messaggio all'applicazione che ha eseguito la chiamata.Removes the current message from a transactional queue and returns the message to the calling application. Non esistono timeout specifici per l'arrivo di un messaggio nella coda.There is no timeout specified for a message to arrive in the queue.

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

Rimuove il messaggio corrente da una coda e restituisce il messaggio all'applicazione che ha eseguito la chiamata.Removes the current message from a queue and returns the message to the calling application. Non esistono timeout specifici per l'arrivo di un messaggio nella coda.There is no timeout specified for a message to arrive in the queue.

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

Rimuove il messaggio corrente dalla coda e restituisce il messaggio all'applicazione che ha eseguito la chiamata.Removes the current message from the queue and returns the message to the calling application. Se è necessario rimuovere un messaggio, il metodo lo restituisce immediatamente.If there is a message to remove, the method returns it immediately. In caso contrario, il metodo attende il timeout specificato per l'arrivo di un nuovo messaggio.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)

Rimuove il messaggio corrente da una coda transazionale e restituisce il messaggio all'applicazione che ha eseguito la chiamata.Removes the current message from a transactional queue and returns the message to the calling application. Se è necessario rimuovere un messaggio, il metodo lo restituisce immediatamente.If there is a message to remove, the method returns it immediately. In caso contrario, il metodo attende il timeout specificato per l'arrivo di un nuovo messaggio.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)

Rimuove il messaggio corrente da una coda e restituisce il messaggio all'applicazione che ha eseguito la chiamata.Removes the current message from a queue and returns the message to the calling application. Se è necessario rimuovere un messaggio, il metodo lo restituisce immediatamente.If there is a message to remove, the method returns it immediately. In caso contrario, il metodo attende il timeout specificato per l'arrivo di un nuovo messaggio.Otherwise, the method waits the specified timeout for a new message to arrive.

Commenti

Il comportamento descritto per questi overload è applicabile solo se l' MessageEnumerator istanza viene recuperata GetMessageEnumerator2tramite.The behavior described for these overloads is applicable only if the MessageEnumerator instance is retrieved by using the GetMessageEnumerator2. Non utilizzare GetMessageEnumerator per recuperare un'istanza di MessageEnumerator poiché questo metodo è stato deprecato.Do not use GetMessageEnumerator to retrieve an instance of MessageEnumerator as this method has been deprecated.

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

Rimuove il messaggio corrente da una coda transazionale o non transazionale e restituisce il messaggio all'applicazione che ha eseguito la chiamata.Removes the current message from a transactional or non-transactional queue and returns the message to the calling application. Non esistono timeout specifici per l'arrivo di un messaggio nella coda.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

Restituisce

Oggetto Message che fa riferimento al primo messaggio disponibile nella coda.A Message that references the first message available in the queue.

Commenti

RemoveCurrentrimuove e restituisce il messaggio in corrispondenza della posizione corrente del cursore.RemoveCurrent removes and returns the message at the cursor's current location.

Se si utilizza il journaling della coda, la rimozione del messaggio comporta la mantenuta di una copia nella coda journal, proprio MessageQueue come il Receive metodo della classe.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.

Quando si rimuove il messaggio corrente, il cursore viene spostato al messaggio successivo.When you remove the current message, the cursor is moved to the next message. Non è necessario chiamare MoveNext dopo la chiamata RemoveCurrenta.You do not have to call MoveNext after calling RemoveCurrent.

Se si chiama questo overload su una coda transazionale, Accodamento messaggi crea una singola transazione interna.If you call this overload on a transactional queue, Message Queuing creates a single internal transaction.

Vedi anche

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

Rimuove il messaggio corrente da una coda transazionale e restituisce il messaggio all'applicazione che ha eseguito la chiamata.Removes the current message from a transactional queue and returns the message to the calling application. Non esistono timeout specifici per l'arrivo di un messaggio nella coda.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

Parametri

transaction
MessageQueueTransaction MessageQueueTransaction MessageQueueTransaction MessageQueueTransaction

L'oggetto MessageQueueTransaction che specifica la transazione nella quale verrà rimosso il messaggio.The MessageQueueTransaction object that specifies the transaction in which the message will be removed.

Restituisce

Oggetto Message che fa riferimento al primo messaggio disponibile nella coda.A Message that references the first message available in the queue.

Eccezioni

Il valore del parametro transaction è null.The transaction parameter is null.

Commenti

RemoveCurrentrimuove e restituisce il messaggio in corrispondenza della posizione corrente del cursore, utilizzando il contesto di transazione interno definito transaction dal parametro.RemoveCurrent removes and returns the message at the cursor's current location, using the internal transaction context defined by the transaction parameter.

Se si utilizza il journaling della coda, la rimozione del messaggio comporta la mantenuta di una copia nella coda journal, proprio MessageQueue come il Receive metodo della classe.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.

Quando si utilizzano le code transazionali, il rollback di una transazione causa la restituzione alla coda di tutti RemoveCurrent i messaggi rimossi da una chiamata a.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 rimozione non è irreversibile fino a quando non viene eseguito il commit della transazione.The removal is not irreversible until the transaction is committed.

Quando si rimuove il messaggio corrente, il cursore viene spostato al messaggio successivo.When you remove the current message, the cursor is moved to the next message. Non è necessario chiamare MoveNext dopo la chiamata RemoveCurrenta.You do not have to call MoveNext after calling RemoveCurrent.

Vedi anche

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

Rimuove il messaggio corrente da una coda e restituisce il messaggio all'applicazione che ha eseguito la chiamata.Removes the current message from a queue and returns the message to the calling application. Non esistono timeout specifici per l'arrivo di un messaggio nella coda.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

Parametri

transactionType
MessageQueueTransactionType MessageQueueTransactionType MessageQueueTransactionType MessageQueueTransactionType

Uno dei valori di MessageQueueTransactionType che descrive il tipo di contesto di transazione da associare al messaggio.One of the MessageQueueTransactionType values, describing the type of transaction context to associate with the message.

Restituisce

Oggetto Message che fa riferimento al primo messaggio disponibile nella coda.A Message that references the first message available in the queue.

Eccezioni

Il parametro transactionType non è uno dei membri di MessageQueueTransactionType.The transactionType parameter is not one of the MessageQueueTransactionType members.

Commenti

RemoveCurrentrimuove e restituisce il messaggio in corrispondenza della posizione corrente del cursore utilizzando un contesto di transazione definito dal transactionType parametro.RemoveCurrent removes and returns the message at the cursor's current location, using a transaction context defined by the transactionType parameter.

Specificare Automatic per il transactionType parametro se è già presente un contesto di transazione esterno collegato al thread che si desidera utilizzare per ricevere il messaggio.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. Specificare Single se si desidera ricevere il messaggio come una singola transazione interna.Specify Single if you want to receive the message as a single internal transaction. È possibile specificare None se si desidera ricevere un messaggio da una coda transazionale all'esterno di un contesto di transazione.You can specify None if you want to receive a message from a transactional queue outside of a transaction context.

Se si utilizza il journaling della coda, la rimozione del messaggio comporta la mantenuta di una copia nella coda journal, proprio MessageQueue come il Receive metodo della classe.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.

Quando si utilizzano le code transazionali, il rollback di una transazione causa la restituzione alla coda di tutti RemoveCurrent i messaggi rimossi da una chiamata a.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 rimozione non è irreversibile fino a quando non viene eseguito il commit della transazione.The removal is not irreversible until the transaction is committed.

Quando si rimuove il messaggio corrente, il cursore viene spostato al messaggio successivo.When you remove the current message, the cursor is moved to the next message. Non è necessario chiamare MoveNext dopo la chiamata RemoveCurrenta.You do not have to call MoveNext after calling RemoveCurrent.

Vedi anche

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

Rimuove il messaggio corrente dalla coda e restituisce il messaggio all'applicazione che ha eseguito la chiamata.Removes the current message from the queue and returns the message to the calling application. Se è necessario rimuovere un messaggio, il metodo lo restituisce immediatamente.If there is a message to remove, the method returns it immediately. In caso contrario, il metodo attende il timeout specificato per l'arrivo di un nuovo messaggio.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

Parametri

timeout
TimeSpan TimeSpan TimeSpan TimeSpan

Il tempo di attesa dell'arrivo del messaggio nella coda.The interval of time to wait for a message to arrive in the queue.

Restituisce

Oggetto Message che fa riferimento al primo messaggio disponibile nella coda.A Message that references the first message available in the queue.

Eccezioni

Il valore specificato per il parametro timeout non è valido.The value specified for the timeout parameter is invalid.

Commenti

RemoveCurrentrimuove e restituisce il messaggio in corrispondenza della posizione corrente del cursore.RemoveCurrent removes and returns the message at the cursor's current location. Se il cursore si trova alla fine della coda, questo overload del metodo attende fino a quando non è disponibile un messaggio o l'intervallo specificato dal timeout parametro è scaduto.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.

Se si utilizza il journaling della coda, la rimozione del messaggio comporta la mantenuta di una copia nella coda journal, proprio MessageQueue come il Receive metodo della classe.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.

Quando si rimuove il messaggio corrente, il cursore viene spostato al messaggio successivo.When you remove the current message, the cursor is moved to the next message. Non è necessario chiamare MoveNext dopo la chiamata RemoveCurrenta.You do not have to call MoveNext after calling RemoveCurrent.

Se si chiama questo overload su una coda transazionale, Accodamento messaggi crea una singola transazione interna.If you call this overload on a transactional queue, Message Queuing creates a single internal transaction.

Vedi anche

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

Rimuove il messaggio corrente da una coda transazionale e restituisce il messaggio all'applicazione che ha eseguito la chiamata.Removes the current message from a transactional queue and returns the message to the calling application. Se è necessario rimuovere un messaggio, il metodo lo restituisce immediatamente.If there is a message to remove, the method returns it immediately. In caso contrario, il metodo attende il timeout specificato per l'arrivo di un nuovo messaggio.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

Parametri

timeout
TimeSpan TimeSpan TimeSpan TimeSpan

Il tempo di attesa per l'eliminazione del messaggio.The interval of time to wait for the message to be removed.

transaction
MessageQueueTransaction MessageQueueTransaction MessageQueueTransaction MessageQueueTransaction

L'oggetto MessageQueueTransaction che specifica il contesto della transazione per il messaggio.The MessageQueueTransaction object that specifies the transaction context for the message.

Restituisce

Oggetto Message che fa riferimento al primo messaggio disponibile nella coda.A Message that references the first message available in the queue.

Eccezioni

Il valore specificato per il parametro timeout non è valido.The value specified for the timeout parameter is invalid.

Il valore del parametro transaction è null.The transaction parameter is null.

Commenti

RemoveCurrentrimuove e restituisce il messaggio in corrispondenza della posizione corrente del cursore.RemoveCurrent removes and returns the message at the cursor's current location. Se il cursore si trova alla fine della coda, questo overload del metodo attende fino a quando non è disponibile un messaggio o l'intervallo specificato dal timeout parametro è scaduto.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.

Quando si utilizzano le code transazionali, il rollback di una transazione causa la restituzione alla coda di tutti RemoveCurrent i messaggi rimossi da una chiamata a.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 rimozione non è irreversibile fino a quando non viene eseguito il commit della transazione.The removal is not irreversible until the transaction is committed.

Se si utilizza il journaling della coda, la rimozione del messaggio comporta la mantenuta di una copia nella coda journal, proprio MessageQueue come il Receive metodo della classe.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.

Quando si rimuove il messaggio corrente, il cursore viene spostato al messaggio successivo.When you remove the current message, the cursor is moved to the next message. Non è necessario chiamare MoveNext dopo la chiamata RemoveCurrenta.You do not have to call MoveNext after calling RemoveCurrent.

Vedi anche

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

Rimuove il messaggio corrente da una coda e restituisce il messaggio all'applicazione che ha eseguito la chiamata.Removes the current message from a queue and returns the message to the calling application. Se è necessario rimuovere un messaggio, il metodo lo restituisce immediatamente.If there is a message to remove, the method returns it immediately. In caso contrario, il metodo attende il timeout specificato per l'arrivo di un nuovo messaggio.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

Parametri

timeout
TimeSpan TimeSpan TimeSpan TimeSpan

Il tempo di attesa per l'eliminazione del messaggio.The interval of time to wait for the message to be removed.

transactionType
MessageQueueTransactionType MessageQueueTransactionType MessageQueueTransactionType MessageQueueTransactionType

Uno dei valori di MessageQueueTransactionType che descrive il tipo di contesto di transazione da associare al messaggio.One of the MessageQueueTransactionType values, describing the type of transaction context to associate with the message.

Restituisce

Oggetto Message che fa riferimento al primo messaggio disponibile nella coda.A Message that references the first message available in the queue.

Eccezioni

Il valore specificato per il parametro timeout non è valido.The value specified for the timeout parameter is invalid.

Il parametro transactionType non è uno dei membri di MessageQueueTransactionType.The transactionType parameter is not one of the MessageQueueTransactionType members.

Commenti

RemoveCurrentrimuove e restituisce il messaggio in corrispondenza della posizione corrente del cursore utilizzando un contesto di transazione definito dal transactionType parametro.RemoveCurrent removes and returns the message at the cursor's current location, using a transaction context defined by the transactionType parameter. Se il cursore si trova alla fine della coda, questo overload del metodo attende fino a quando non è disponibile un messaggio o l'intervallo specificato dal timeout parametro è scaduto.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.

Specificare Automatic per il transactionType parametro se è già presente un contesto di transazione esterno collegato al thread che si desidera utilizzare per ricevere il messaggio.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. Specificare Single se si desidera ricevere il messaggio come una singola transazione interna.Specify Single if you want to receive the message as a single internal transaction. È possibile specificare None se si desidera ricevere un messaggio da una coda transazionale all'esterno di un contesto di transazione.You can specify None if you want to receive a message from a transactional queue outside of a transaction context.

Se si utilizza il journaling della coda, la rimozione del messaggio comporta la mantenuta di una copia nella coda journal, proprio MessageQueue come il Receive metodo della classe.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.

Quando si utilizzano le code transazionali, il rollback di una transazione causa la restituzione alla coda di tutti RemoveCurrent i messaggi rimossi da una chiamata a.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 rimozione non è irreversibile fino a quando non viene eseguito il commit della transazione.The removal is not irreversible until the transaction is committed.

Quando si rimuove il messaggio corrente, il cursore viene spostato al messaggio successivo.When you remove the current message, the cursor is moved to the next message. Non è necessario chiamare MoveNext dopo la chiamata RemoveCurrenta.You do not have to call MoveNext after calling RemoveCurrent.

Vedi anche

Si applica a