QueueClient.UpdateMessageAsync 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.
Surcharges
| UpdateMessageAsync(String, String, BinaryData, TimeSpan, CancellationToken) |
Modifie le délai d’expiration et le contenu de la visibilité d’un message. Un message doit être dans un format qui peut être inclus dans une demande XML en UTF-8. Sinon, MessageEncoding l’option peut être définie sur Base64 pour gérer les messages non conformes. La taille du message encodé peut atteindre 64 Kio pour les versions 2011-08-18 et ultérieures, ou 8 Kio pour les versions précédentes. Pour plus d'informations, consultez la rubrique Mettre à jour le message. |
| UpdateMessageAsync(String, String, String, TimeSpan, CancellationToken) |
Modifie le délai d’expiration et le contenu de la visibilité d’un message. Un message doit être dans un format qui peut être inclus dans une demande XML en UTF-8. Sinon, MessageEncoding l’option peut être définie sur Base64 pour gérer les messages non conformes. La taille du message encodé peut atteindre 64 Kio pour les versions 2011-08-18 et ultérieures, ou 8 Kio pour les versions précédentes. Pour plus d'informations, consultez la rubrique Mettre à jour le message. |
UpdateMessageAsync(String, String, BinaryData, TimeSpan, CancellationToken)
- Source:
- QueueClient.cs
- Source:
- QueueClient.cs
Modifie le délai d’expiration et le contenu de la visibilité d’un message.
Un message doit être dans un format qui peut être inclus dans une demande XML en UTF-8. Sinon, MessageEncoding l’option peut être définie sur Base64 pour gérer les messages non conformes. La taille du message encodé peut atteindre 64 Kio pour les versions 2011-08-18 et ultérieures, ou 8 Kio pour les versions précédentes.
Pour plus d'informations, consultez la rubrique Mettre à jour le message.
public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Queues.Models.UpdateReceipt>> UpdateMessageAsync (string messageId, string popReceipt, BinaryData message, TimeSpan visibilityTimeout = default, System.Threading.CancellationToken cancellationToken = default);abstract member UpdateMessageAsync : string * string * BinaryData * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Queues.Models.UpdateReceipt>>
override this.UpdateMessageAsync : string * string * BinaryData * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Queues.Models.UpdateReceipt>>Public Overridable Function UpdateMessageAsync (messageId As String, popReceipt As String, message As BinaryData, Optional visibilityTimeout As TimeSpan = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of UpdateReceipt))Paramètres
- messageId
- String
ID du message à mettre à jour.
- popReceipt
- String
Obligatoire. Spécifie la valeur de réception contextuelle valide retournée à partir d’un appel antérieur à l’opération Obtenir des messages ou Mettre à jour le message.
- message
- BinaryData
facultatif. Message mis à jour.
- visibilityTimeout
- TimeSpan
Obligatoire. Spécifie la nouvelle valeur du délai de visibilité, en secondes, par rapport au temps serveur. La nouvelle valeur doit être supérieure ou égale à 0 et ne peut pas être supérieure à 7 jours. Le délai d'expiration de la visibilité d'un message ne peut pas être défini à une valeur ultérieure au délai d'expiration. Un message peut être mis à jour tant qu'il n'a pas été supprimé ou qu'il n'a pas expiré.
- cancellationToken
- CancellationToken
CancellationToken optionnel.
Retours
Remarques
Cette version de la bibliothèque n’encode pas le message par défaut. Base64 était le comportement par défaut dans la bibliothèque v11 précédente. Consultez CloudQueue.EncodeMessage.
S’applique à
UpdateMessageAsync(String, String, String, TimeSpan, CancellationToken)
- Source:
- QueueClient.cs
- Source:
- QueueClient.cs
Modifie le délai d’expiration et le contenu de la visibilité d’un message.
Un message doit être dans un format qui peut être inclus dans une demande XML en UTF-8. Sinon, MessageEncoding l’option peut être définie sur Base64 pour gérer les messages non conformes. La taille du message encodé peut atteindre 64 Kio pour les versions 2011-08-18 et ultérieures, ou 8 Kio pour les versions précédentes.
Pour plus d'informations, consultez la rubrique Mettre à jour le message.
public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Queues.Models.UpdateReceipt>> UpdateMessageAsync (string messageId, string popReceipt, string messageText = default, TimeSpan visibilityTimeout = default, System.Threading.CancellationToken cancellationToken = default);abstract member UpdateMessageAsync : string * string * string * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Queues.Models.UpdateReceipt>>
override this.UpdateMessageAsync : string * string * string * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Queues.Models.UpdateReceipt>>Public Overridable Function UpdateMessageAsync (messageId As String, popReceipt As String, Optional messageText As String = Nothing, Optional visibilityTimeout As TimeSpan = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of UpdateReceipt))Paramètres
- messageId
- String
ID du message à mettre à jour.
- popReceipt
- String
Obligatoire. Spécifie la valeur de réception contextuelle valide retournée à partir d’un appel antérieur à l’opération Obtenir des messages ou Mettre à jour le message.
- messageText
- String
facultatif. Texte du message mis à jour.
- visibilityTimeout
- TimeSpan
Obligatoire. Spécifie la nouvelle valeur du délai de visibilité, en secondes, par rapport au temps serveur. La nouvelle valeur doit être supérieure ou égale à 0 et ne peut pas être supérieure à 7 jours. Le délai d'expiration de la visibilité d'un message ne peut pas être défini à une valeur ultérieure au délai d'expiration. Un message peut être mis à jour tant qu'il n'a pas été supprimé ou qu'il n'a pas expiré.
- cancellationToken
- CancellationToken
CancellationToken optionnel.
Retours
Remarques
Cette version de la bibliothèque n’encode pas le message par défaut. Base64 était le comportement par défaut dans la bibliothèque v11 précédente. Consultez CloudQueue.EncodeMessage.
S’applique à
Azure SDK for .NET