MessageEnumerator.RemoveCurrent Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Supprime le message en cours de la file d'attente et retourne le message à l'application appelante. La suppression du message l'efface de la file d'attente.
Surcharges
| RemoveCurrent() |
Supprime le message en cours d'une file d'attente transactionnelle ou non et retourne le message à l'application appelante. Il n'y a pas de délai d'attente spécifié pour l'arrivée d'un message dans la file d'attente. |
| RemoveCurrent(MessageQueueTransaction) |
Supprime le message en cours d'une file d'attente transactionnelle et retourne le message à l'application appelante. Il n'y a pas de délai d'attente spécifié pour l'arrivée d'un message dans la file d'attente. |
| RemoveCurrent(MessageQueueTransactionType) |
Supprime le message en cours d'une file d'attente et retourne le message à l'application appelante. Il n'y a pas de délai d'attente spécifié pour l'arrivée d'un message dans la file d'attente. |
| RemoveCurrent(TimeSpan) |
Supprime le message en cours de la file d'attente et retourne le message à l'application appelante. S'il y a un message à supprimer, le retour de la méthode est immédiat. Sinon, la méthode attend le délai spécifié pour l'arrivée d'un message. |
| RemoveCurrent(TimeSpan, MessageQueueTransaction) |
Supprime le message en cours d'une file d'attente transactionnelle et retourne le message à l'application appelante. S'il y a un message à supprimer, le retour de la méthode est immédiat. Sinon, la méthode attend le délai spécifié pour l'arrivée d'un message. |
| RemoveCurrent(TimeSpan, MessageQueueTransactionType) |
Supprime le message en cours d'une file d'attente et retourne le message à l'application appelante. S'il y a un message à supprimer, le retour de la méthode est immédiat. Sinon, la méthode attend le délai spécifié pour l'arrivée d'un message. |
Remarques
Le comportement décrit pour ces surcharges s’applique uniquement si le MessageEnumerator instance est récupéré à l’aide de GetMessageEnumerator2. N’utilisez GetMessageEnumerator pas pour récupérer un instance deMessageEnumerator, car cette méthode a été déconseillée.
RemoveCurrent()
Supprime le message en cours d'une file d'attente transactionnelle ou non et retourne le message à l'application appelante. Il n'y a pas de délai d'attente spécifié pour l'arrivée d'un message dans la file d'attente.
public:
System::Messaging::Message ^ RemoveCurrent();public System.Messaging.Message RemoveCurrent ();member this.RemoveCurrent : unit -> System.Messaging.MessagePublic Function RemoveCurrent () As MessageRetours
Message référençant le premier message disponible dans la file d'attente.
Remarques
RemoveCurrent supprime et retourne le message à l’emplacement actuel du curseur.
Si vous utilisez la journalisation de file d’attente, la suppression du message entraîne le maintien d’une copie dans la file d’attente du journal, comme le fait la méthode de Receive la MessageQueue classe.
Lorsque vous supprimez le message actuel, le curseur est déplacé vers le message suivant. Vous n’avez pas besoin d’appeler MoveNext après avoir appelé RemoveCurrent.
Si vous appelez cette surcharge sur une file d’attente transactionnelle, Message Queuing crée une seule transaction interne.
Voir aussi
S’applique à
RemoveCurrent(MessageQueueTransaction)
Supprime le message en cours d'une file d'attente transactionnelle et retourne le message à l'application appelante. Il n'y a pas de délai d'attente spécifié pour l'arrivée d'un message dans la file d'attente.
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 MessageParamètres
- transaction
- MessageQueueTransaction
L'objet MessageQueueTransaction qui spécifie la transaction dans laquelle le message sera supprimé.
Retours
Message référençant le premier message disponible dans la file d'attente.
Exceptions
Le paramètre transaction a la valeur null.
Remarques
RemoveCurrent supprime et retourne le message à l’emplacement actuel du curseur, à l’aide du contexte de transaction interne défini par le transaction paramètre .
Si vous utilisez la journalisation de file d’attente, la suppression du message entraîne le maintien d’une copie dans la file d’attente du journal, comme le fait la méthode de Receive la MessageQueue classe.
Lors de l’utilisation de files d’attente transactionnelles, une restauration d’une transaction entraîne le retour de tous les messages supprimés par un appel RemoveCurrent à la file d’attente. La suppression n’est pas irréversible tant que la transaction n’est pas validée.
Lorsque vous supprimez le message actuel, le curseur est déplacé vers le message suivant. Vous n’avez pas besoin d’appeler MoveNext après avoir appelé RemoveCurrent.
Voir aussi
S’applique à
RemoveCurrent(MessageQueueTransactionType)
Supprime le message en cours d'une file d'attente et retourne le message à l'application appelante. Il n'y a pas de délai d'attente spécifié pour l'arrivée d'un message dans la file d'attente.
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 MessageParamètres
- transactionType
- MessageQueueTransactionType
Une des valeurs de MessageQueueTransactionType décrivant le type de contexte de transaction à associer au message.
Retours
Message référençant le premier message disponible dans la file d'attente.
Exceptions
Le paramètre transactionType ne fait pas partie des membres MessageQueueTransactionType.
Remarques
RemoveCurrent supprime et retourne le message à l’emplacement actuel du curseur, à l’aide d’un contexte de transaction défini par le transactionType paramètre .
Spécifiez Automatic pour le transactionType paramètre s’il existe déjà un contexte de transaction externe attaché au thread que vous souhaitez utiliser pour recevoir le message. Spécifiez Single si vous souhaitez recevoir le message en tant que transaction interne unique. Vous pouvez spécifier None si vous souhaitez recevoir un message d’une file d’attente transactionnelle en dehors d’un contexte de transaction.
Si vous utilisez la journalisation de file d’attente, la suppression du message entraîne le maintien d’une copie dans la file d’attente du journal, comme le fait la méthode de Receive la MessageQueue classe.
Lors de l’utilisation de files d’attente transactionnelles, une restauration d’une transaction entraîne le retour de tous les messages supprimés par un appel RemoveCurrent à la file d’attente. La suppression n’est pas irréversible tant que la transaction n’est pas validée.
Lorsque vous supprimez le message actuel, le curseur est déplacé vers le message suivant. Vous n’avez pas besoin d’appeler MoveNext après avoir appelé RemoveCurrent.
Voir aussi
S’applique à
RemoveCurrent(TimeSpan)
Supprime le message en cours de la file d'attente et retourne le message à l'application appelante. S'il y a un message à supprimer, le retour de la méthode est immédiat. Sinon, la méthode attend le délai spécifié pour l'arrivée d'un message.
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 MessageParamètres
- timeout
- TimeSpan
La durée d'attente pour l'arrivée d'un message dans la file d'attente.
Retours
Message référençant le premier message disponible dans la file d'attente.
Exceptions
La valeur spécifiée pour le paramètre timeout est non valide.
Le délai a expiré.
Remarques
RemoveCurrent supprime et retourne le message à l’emplacement actuel du curseur. Si le curseur se trouve à la fin de la file d’attente, cette surcharge de la méthode attend qu’un message soit disponible ou que l’intervalle spécifié par le timeout paramètre ait expiré.
Si vous utilisez la journalisation de file d’attente, la suppression du message entraîne le maintien d’une copie dans la file d’attente du journal, comme le fait la méthode de Receive la MessageQueue classe.
Lorsque vous supprimez le message actuel, le curseur est déplacé vers le message suivant. Vous n’avez pas besoin d’appeler MoveNext après avoir appelé RemoveCurrent.
Si vous appelez cette surcharge sur une file d’attente transactionnelle, Message Queuing crée une seule transaction interne.
Voir aussi
S’applique à
RemoveCurrent(TimeSpan, MessageQueueTransaction)
Supprime le message en cours d'une file d'attente transactionnelle et retourne le message à l'application appelante. S'il y a un message à supprimer, le retour de la méthode est immédiat. Sinon, la méthode attend le délai spécifié pour l'arrivée d'un message.
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 MessageParamètres
- timeout
- TimeSpan
Durée d'attente pour la suppression d'un message.
- transaction
- MessageQueueTransaction
L'objet MessageQueueTransaction qui spécifie le contexte de la transaction pour le message.
Retours
Message référençant le premier message disponible dans la file d'attente.
Exceptions
La valeur spécifiée pour le paramètre timeout est non valide.
Le paramètre transaction a la valeur null.
Le délai a expiré.
Remarques
RemoveCurrent supprime et retourne le message à l’emplacement actuel du curseur. Si le curseur se trouve à la fin de la file d’attente, cette surcharge de la méthode attend qu’un message soit disponible ou que l’intervalle spécifié par le timeout paramètre ait expiré.
Lors de l’utilisation de files d’attente transactionnelles, une restauration d’une transaction entraîne le retour de tous les messages supprimés par un appel RemoveCurrent à la file d’attente. La suppression n’est pas irréversible tant que la transaction n’est pas validée.
Si vous utilisez la journalisation de file d’attente, la suppression du message entraîne le maintien d’une copie dans la file d’attente du journal, comme le fait la méthode de Receive la MessageQueue classe.
Lorsque vous supprimez le message actuel, le curseur est déplacé vers le message suivant. Vous n’avez pas besoin d’appeler MoveNext après avoir appelé RemoveCurrent.
Voir aussi
S’applique à
RemoveCurrent(TimeSpan, MessageQueueTransactionType)
Supprime le message en cours d'une file d'attente et retourne le message à l'application appelante. S'il y a un message à supprimer, le retour de la méthode est immédiat. Sinon, la méthode attend le délai spécifié pour l'arrivée d'un message.
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 MessageParamètres
- timeout
- TimeSpan
Durée d'attente pour la suppression d'un message.
- transactionType
- MessageQueueTransactionType
Une des valeurs de MessageQueueTransactionType décrivant le type de contexte de transaction à associer au message.
Retours
Message référençant le premier message disponible dans la file d'attente.
Exceptions
La valeur spécifiée pour le paramètre timeout est non valide.
Le délai a expiré.
Le paramètre transactionType ne fait pas partie des membres MessageQueueTransactionType.
Remarques
RemoveCurrent supprime et retourne le message à l’emplacement actuel du curseur, à l’aide d’un contexte de transaction défini par le transactionType paramètre . Si le curseur se trouve à la fin de la file d’attente, cette surcharge de la méthode attend qu’un message soit disponible ou que l’intervalle spécifié par le timeout paramètre ait expiré.
Spécifiez Automatic pour le transactionType paramètre s’il existe déjà un contexte de transaction externe attaché au thread que vous souhaitez utiliser pour recevoir le message. Spécifiez Single si vous souhaitez recevoir le message en tant que transaction interne unique. Vous pouvez spécifier None si vous souhaitez recevoir un message d’une file d’attente transactionnelle en dehors d’un contexte de transaction.
Si vous utilisez la journalisation de file d’attente, la suppression du message entraîne le maintien d’une copie dans la file d’attente du journal, comme le fait la méthode de Receive la MessageQueue classe.
Lors de l’utilisation de files d’attente transactionnelles, une restauration d’une transaction entraîne le retour de tous les messages supprimés par un appel RemoveCurrent à la file d’attente. La suppression n’est pas irréversible tant que la transaction n’est pas validée.
Lorsque vous supprimez le message actuel, le curseur est déplacé vers le message suivant. Vous n’avez pas besoin d’appeler MoveNext après avoir appelé RemoveCurrent.
