Freigeben über


QueueClient.UpdateMessage Methode

Definition

Überlädt

UpdateMessage(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 konforme Nachrichten zu verarbeiten. Die codierte Nachricht kann bis zu 64 KiB für Versionen 2011-08-18 und höher oder 8 KiB in früheren Versionen groß sein.

Weitere Informationen finden Sie unter Nachricht aktualisieren.

UpdateMessage(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 konforme Nachrichten zu verarbeiten. Die codierte Nachricht kann bis zu 64 KiB für Versionen 2011-08-18 und höher oder 8 KiB in früheren Versionen groß sein.

Weitere Informationen finden Sie unter Nachricht aktualisieren.

UpdateMessage(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 konforme Nachrichten zu verarbeiten. Die codierte Nachricht kann bis zu 64 KiB für Versionen 2011-08-18 und höher oder 8 KiB in früheren Versionen groß sein.

Weitere Informationen finden Sie unter Nachricht aktualisieren.

public virtual Azure.Response<Azure.Storage.Queues.Models.UpdateReceipt> UpdateMessage (string messageId, string popReceipt, BinaryData message, TimeSpan visibilityTimeout = default, System.Threading.CancellationToken cancellationToken = default);
abstract member UpdateMessage : string * string * BinaryData * TimeSpan * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Queues.Models.UpdateReceipt>
override this.UpdateMessage : string * string * BinaryData * TimeSpan * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Queues.Models.UpdateReceipt>
Public Overridable Function UpdateMessage (messageId As String, popReceipt As String, message As BinaryData, Optional visibilityTimeout As TimeSpan = Nothing, Optional cancellationToken As CancellationToken = Nothing) As 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. Meldung 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:

UpdateMessage(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 konforme Nachrichten zu verarbeiten. Die codierte Nachricht kann bis zu 64 KiB für Versionen 2011-08-18 und höher oder 8 KiB in früheren Versionen groß sein.

Weitere Informationen finden Sie unter Nachricht aktualisieren.

public virtual Azure.Response<Azure.Storage.Queues.Models.UpdateReceipt> UpdateMessage (string messageId, string popReceipt, string messageText = default, TimeSpan visibilityTimeout = default, System.Threading.CancellationToken cancellationToken = default);
abstract member UpdateMessage : string * string * string * TimeSpan * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Queues.Models.UpdateReceipt>
override this.UpdateMessage : string * string * string * TimeSpan * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Queues.Models.UpdateReceipt>
Public Overridable Function UpdateMessage (messageId As String, popReceipt As String, Optional messageText As String = Nothing, Optional visibilityTimeout As TimeSpan = Nothing, Optional cancellationToken As CancellationToken = Nothing) As 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 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: