BlockBlobClient.StageBlock Méthode

Définition

Espace de noms:

Azure.Storage.Blobs.Specialized

Assembly:

Azure.Storage.Blobs.dll

Paquet:

Azure.Storage.Blobs v12.20.0

Source:

BlockBlobClient.cs

L’opération StageBlock(String, Stream, BlockBlobStageBlockOptions, CancellationToken) crée un nouveau bloc dans le cadre de la « zone de préproduction » 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 Placez Bloquer.

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

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

Public Overridable Function StageBlock (base64BlockId As String, content As Stream, Optional options As BlockBlobStageBlockOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As 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

Response<BlockInfo>

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

Remarques

Un RequestFailedException sera levée en cas d’échec.