Freigeben über


QueueClient.UpdateMessageAsync Methode

Definition

Überlädt

UpdateMessageAsync(String, String, BinaryData, TimeSpan, CancellationToken)

Ändert das Sichtbarkeitstimeout und den Inhalt einer Nachricht.

Nachrichten müssen ein Format aufweisen, das in eine XML-Anforderung mit UTF-8-Codierung eingeschlossen werden kann. Andernfalls MessageEncoding kann die Option auf Base64 festgelegt werden, um nicht kompatible Nachrichten zu verarbeiten. Die codierte Nachricht kann für Versionen 2011-08-18 und höher bis zu 64 KiB oder 8 KiB für frühere Versionen groß sein.

Weitere Informationen finden Sie unter Nachricht aktualisieren.

UpdateMessageAsync(String, String, String, TimeSpan, CancellationToken)

Ändert das Sichtbarkeitstimeout und den Inhalt einer Nachricht.

Nachrichten müssen ein Format aufweisen, das in eine XML-Anforderung mit UTF-8-Codierung eingeschlossen werden kann. Andernfalls MessageEncoding kann die Option auf Base64 festgelegt werden, um nicht kompatible Nachrichten zu verarbeiten. Die codierte Nachricht kann für Versionen 2011-08-18 und höher bis zu 64 KiB oder 8 KiB für frühere Versionen groß sein.

Weitere Informationen finden Sie unter Nachricht aktualisieren.

UpdateMessageAsync(String, String, BinaryData, TimeSpan, CancellationToken)

Quelle:
QueueClient.cs
Quelle:
QueueClient.cs

Ändert das Sichtbarkeitstimeout und den Inhalt einer Nachricht.

Nachrichten müssen ein Format aufweisen, das in eine XML-Anforderung mit UTF-8-Codierung eingeschlossen werden kann. Andernfalls MessageEncoding kann die Option auf Base64 festgelegt werden, um nicht kompatible Nachrichten zu verarbeiten. Die codierte Nachricht kann für Versionen 2011-08-18 und höher bis zu 64 KiB oder 8 KiB für frühere Versionen groß sein.

Weitere Informationen finden Sie unter Nachricht aktualisieren.

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))

Parameter

messageId
String

ID der zu aktualisierenden Nachricht.

popReceipt
String

Erforderlich. Gibt den gültigen Pop-Belegwert an, der von einem früheren Aufruf des Vorgangs "Nachrichten abrufen" oder "Nachricht aktualisieren" zurückgegeben wurde.

message
BinaryData

Optional. Nachricht aktualisiert.

visibilityTimeout
TimeSpan

Erforderlich. Gibt den neuen Sichtbarkeitstimeoutwert in Sekunden relativ zur Serverzeit an. Der neue Wert muss größer oder gleich 0 sein und darf nicht größer als 7 Tage sein. Das Sichtbarkeitstimeout einer Nachricht darf nicht auf einen Wert festgelegt werden, der nach der Ablaufzeit liegt. Eine Nachricht kann aktualisiert werden, bis sie gelöscht wurde oder abgelaufen ist.

cancellationToken
CancellationToken

Optionale CancellationToken.

Gibt zurück

Response<T>.

Hinweise

Diese Version der Bibliothek codiert die Nachricht standardmäßig nicht. Base64 war das Standardverhalten in der vorherigen v11-Bibliothek. Siehe CloudQueue.EncodeMessage.

Gilt für:

UpdateMessageAsync(String, String, String, TimeSpan, CancellationToken)

Quelle:
QueueClient.cs
Quelle:
QueueClient.cs

Ändert das Sichtbarkeitstimeout und den Inhalt einer Nachricht.

Nachrichten müssen ein Format aufweisen, das in eine XML-Anforderung mit UTF-8-Codierung eingeschlossen werden kann. Andernfalls MessageEncoding kann die Option auf Base64 festgelegt werden, um nicht kompatible Nachrichten zu verarbeiten. Die codierte Nachricht kann für Versionen 2011-08-18 und höher bis zu 64 KiB oder 8 KiB für frühere Versionen groß sein.

Weitere Informationen finden Sie unter Nachricht aktualisieren.

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))

Parameter

messageId
String

ID der zu aktualisierenden Nachricht.

popReceipt
String

Erforderlich. Gibt den gültigen Pop-Belegwert an, der von einem früheren Aufruf des Vorgangs "Nachrichten abrufen" oder "Nachricht aktualisieren" zurückgegeben wurde.

messageText
String

Optional. Nachrichtentext wurde aktualisiert.

visibilityTimeout
TimeSpan

Erforderlich. Gibt den neuen Sichtbarkeitstimeoutwert in Sekunden relativ zur Serverzeit an. Der neue Wert muss größer oder gleich 0 sein und darf nicht größer als 7 Tage sein. Das Sichtbarkeitstimeout einer Nachricht darf nicht auf einen Wert festgelegt werden, der nach der Ablaufzeit liegt. Eine Nachricht kann aktualisiert werden, bis sie gelöscht wurde oder abgelaufen ist.

cancellationToken
CancellationToken

Optionale CancellationToken.

Gibt zurück

Response<T>.

Hinweise

Diese Version der Bibliothek codiert die Nachricht standardmäßig nicht. Base64 war das Standardverhalten in der vorherigen v11-Bibliothek. Siehe CloudQueue.EncodeMessage.

Gilt für: