BlockBlobClient.StageBlockAsync Méthode

Définition

Espace de noms:

Azure.Storage.Blobs.Specialized

Assembly:

Azure.Storage.Blobs.dll

Paquet:

Azure.Storage.Blobs v12.19.1

Source:

BlockBlobClient.cs

L’opération StageBlockAsync(String, Stream, BlockBlobStageBlockOptions, CancellationToken) crée un bloc dans le cadre de la « zone intermédiaire » d’un objet blob de blocs pour qu’il soit finalement validé via l’opération CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) .

Pour plus d'informations, consultez la rubrique Mettez bloquer.

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlockInfo>> StageBlockAsync (string base64BlockId, System.IO.Stream content, Azure.Storage.Blobs.Models.BlockBlobStageBlockOptions options = default, System.Threading.CancellationToken cancellationToken = default);

abstract member StageBlockAsync : string * System.IO.Stream * Azure.Storage.Blobs.Models.BlockBlobStageBlockOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlockInfo>>
override this.StageBlockAsync : string * System.IO.Stream * Azure.Storage.Blobs.Models.BlockBlobStageBlockOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlockInfo>>

Public Overridable Function StageBlockAsync (base64BlockId As String, content As Stream, Optional options As BlockBlobStageBlockOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of BlockInfo))

Paramètres

base64BlockId

String

Une valeur de chaîne Base64 valide qui identifie le bloc. Avant l'encodage, la taille de la chaîne doit être inférieure ou égale à 64 octets.

Pour un objet blob donné, la longueur de la valeur spécifiée pour le paramètre blockid doit être de la même taille pour chaque bloc. Notez que la chaîne Base64 doit être encodée dans l'URL.

content

Stream

Stream contenant le contenu à charger.

options

BlockBlobStageBlockOptions

Paramètres facultatifs.

cancellationToken

CancellationToken

Facultatif CancellationToken pour propager des notifications indiquant que l’opération doit être annulée.

Retours

Task<Response<BlockInfo>>

Response<T> décrivant l’état du bloc mis à jour.

Remarques

Un RequestFailedException est levée si une défaillance se produit.