MessageEnumerator.RemoveCurrent Méthode

Définition

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.Message
Public Function RemoveCurrent () As Message

Retours

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.Message
Public Function RemoveCurrent (transaction As MessageQueueTransaction) As Message

Paramè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.Message
Public Function RemoveCurrent (transactionType As MessageQueueTransactionType) As Message

Paramè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.Message
Public Function RemoveCurrent (timeout As TimeSpan) As Message

Paramè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.Message
Public Function RemoveCurrent (timeout As TimeSpan, transaction As MessageQueueTransaction) As Message

Paramè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.Message
Public Function RemoveCurrent (timeout As TimeSpan, transactionType As MessageQueueTransactionType) As Message

Paramè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.

Voir aussi

S’applique à