QueueClient.UpdateMessageAsync 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í.
Sobrecargas
| UpdateMessageAsync(String, String, BinaryData, TimeSpan, CancellationToken) |
Cambia el tiempo de espera y el contenido de visibilidad de un mensaje. Un mensaje debe estar en un formato tal que se pueda incluir en una solicitud XML con codificación UTF-8. De lo contrario MessageEncoding , la opción se puede establecer en Base64 para controlar mensajes no compatibles. El mensaje codificado puede tener un tamaño de hasta 64 KiB para las versiones 2011-08-18 y posteriores, o 8 KiB para versiones anteriores. Para obtener más información, vea Actualizar mensaje. |
| UpdateMessageAsync(String, String, String, TimeSpan, CancellationToken) |
Cambia el tiempo de espera y el contenido de visibilidad de un mensaje. Un mensaje debe estar en un formato tal que se pueda incluir en una solicitud XML con codificación UTF-8. De lo contrario MessageEncoding , la opción se puede establecer en Base64 para controlar mensajes no compatibles. El mensaje codificado puede tener un tamaño de hasta 64 KiB para las versiones 2011-08-18 y posteriores, o 8 KiB para versiones anteriores. Para obtener más información, vea Actualizar mensaje. |
UpdateMessageAsync(String, String, BinaryData, TimeSpan, CancellationToken)
- Source:
- QueueClient.cs
- Source:
- QueueClient.cs
Cambia el tiempo de espera y el contenido de visibilidad de un mensaje.
Un mensaje debe estar en un formato tal que se pueda incluir en una solicitud XML con codificación UTF-8. De lo contrario MessageEncoding , la opción se puede establecer en Base64 para controlar mensajes no compatibles. El mensaje codificado puede tener un tamaño de hasta 64 KiB para las versiones 2011-08-18 y posteriores, o 8 KiB para versiones anteriores.
Para obtener más información, vea Actualizar mensaje.
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))Parámetros
- messageId
- String
Identificador del mensaje que se va a actualizar.
- popReceipt
- String
Necesario. Especifica el valor de recibo pop válido devuelto de una llamada anterior a la operación Obtener mensajes o Actualizar mensaje.
- message
- BinaryData
Opcional. Mensaje actualizado.
- visibilityTimeout
- TimeSpan
Necesario. Especifica el nuevo valor del tiempo de espera de visibilidad, en segundos, relativo a la hora del servidor. El nuevo valor debe ser mayor o igual que 0, y no puede ser mayor de 7 días. El tiempo de espera de visibilidad de un mensaje no puede establecerse en un valor posterior a la hora de expiración. Un mensaje se puede actualizar hasta que se ha eliminado o ha expirado.
- cancellationToken
- CancellationToken
Objeto CancellationToken opcional.
Devoluciones
Comentarios
Esta versión de la biblioteca no codifica el mensaje de forma predeterminada. Base64 era el comportamiento predeterminado en la biblioteca v11 anterior. Consulte CloudQueue.EncodeMessage.
Se aplica a
UpdateMessageAsync(String, String, String, TimeSpan, CancellationToken)
- Source:
- QueueClient.cs
- Source:
- QueueClient.cs
Cambia el tiempo de espera y el contenido de visibilidad de un mensaje.
Un mensaje debe estar en un formato tal que se pueda incluir en una solicitud XML con codificación UTF-8. De lo contrario MessageEncoding , la opción se puede establecer en Base64 para controlar mensajes no compatibles. El mensaje codificado puede tener un tamaño de hasta 64 KiB para las versiones 2011-08-18 y posteriores, o 8 KiB para versiones anteriores.
Para obtener más información, vea Actualizar mensaje.
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))Parámetros
- messageId
- String
Identificador del mensaje que se va a actualizar.
- popReceipt
- String
Necesario. Especifica el valor de recibo pop válido devuelto de una llamada anterior a la operación Obtener mensajes o Actualizar mensaje.
- messageText
- String
Opcional. Texto del mensaje actualizado.
- visibilityTimeout
- TimeSpan
Necesario. Especifica el nuevo valor del tiempo de espera de visibilidad, en segundos, relativo a la hora del servidor. El nuevo valor debe ser mayor o igual que 0, y no puede ser mayor de 7 días. El tiempo de espera de visibilidad de un mensaje no puede establecerse en un valor posterior a la hora de expiración. Un mensaje se puede actualizar hasta que se ha eliminado o ha expirado.
- cancellationToken
- CancellationToken
Objeto CancellationToken opcional.
Devoluciones
Comentarios
Esta versión de la biblioteca no codifica el mensaje de forma predeterminada. Base64 era el comportamiento predeterminado en la biblioteca v11 anterior. Consulte CloudQueue.EncodeMessage.
Se aplica a
Azure SDK for .NET