BlobRequestOptions.RetryPolicy Eigenschaft

Definition

Namespace:

Microsoft.Azure.Storage.Blob

Assembly:

Microsoft.Azure.Storage.Blob.dll

Paket:

Microsoft.Azure.Storage.Blob v11.2.3

Ruft die Wiederholungsrichtlinie für die Anforderung ab oder legt sie fest.

public Microsoft.Azure.Storage.RetryPolicies.IRetryPolicy RetryPolicy { get; set; }

member this.RetryPolicy : Microsoft.Azure.Storage.RetryPolicies.IRetryPolicy with get, set

Public Property RetryPolicy As IRetryPolicy

Eigenschaftswert

IRetryPolicy

Ein Objekt vom Typ IRetryPolicy.

Implementiert

RetryPolicy

Beispiele

// Create a Linear Retry Policy.
// This retry policy will instruct the Storage Client to retry the request in a linear fashion.
// This particular retry policy will retry the request every 20 seconds, up to a maximum of 4 retries.
BlobRequestOptions optionsWithRetryPolicy = new BlobRequestOptions() { RetryPolicy = new RetryPolicies.LinearRetry(TimeSpan.FromSeconds(20), 4) };

int byteCount = blob.DownloadToByteArray(destinationArray, index: 0, accessCondition: null, options: optionsWithRetryPolicy);

// This retry policy will never retry.
optionsWithRetryPolicy = new BlobRequestOptions() { RetryPolicy = new RetryPolicies.NoRetry() };
byteCount = blob.DownloadToByteArray(destinationArray, index: 0, accessCondition: null, options: optionsWithRetryPolicy);

Hinweise

Wiederholungsrichtlinien weisen den Speicherclient an, fehlgeschlagene Anforderungen zu wiederholen. Standardmäßig werden nur einige Fehler wiederholt. Beispielsweise können Verbindungsfehler und Drosselungsfehler wiederholt werden. Ressource nicht gefunden (404) oder Authentifizierungsfehler werden nicht wiederholt, da diese bei einem Wiederholungsversuch wahrscheinlich nicht erfolgreich sind. Wenn nicht festgelegt, verwendet der Speicherclient eine exponentielle Backoff-Wiederholungsrichtlinie, bei der die Wartezeit zwischen Anforderungen exponentiell länger wird, bis zu einer Gesamtdauer von etwa 30 Sekunden. Die Standardwiewiebelrichtlinie wird für die meisten Szenarien empfohlen.