BlockBlobClient.CommitBlockListAsync Método

Definição

Namespace:

Azure.Storage.Blobs.Specialized

Assembly:

Azure.Storage.Blobs.dll

Pacote:

Azure.Storage.Blobs v12.19.1

Origem:

BlockBlobClient.cs

A operação CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) grava um blob especificando a lista de IDs de bloco que constituem o blob. Para ser gravado como parte de um blob, um bloco deve ter sido gravado com êxito no servidor em uma operação Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken) anterior. Você pode chamar CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) para atualizar um blob carregando apenas os blocos que foram alterados e depois confirmando os blocos novos e existentes em conjunto. Para fazer isso, especifique se um bloco deve ser confirmado da lista de blocos confirmados ou da lista de blocos não confirmados, ou confirme a versão mais recente carregada do bloco, independentemente da lista à qual ele pertença. Todos os blocos não especificados na lista de blocos e excluídos permanentemente.

Para obter mais informações, consulte Colocar Lista de Blocos.

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>> CommitBlockListAsync (System.Collections.Generic.IEnumerable<string> base64BlockIds, Azure.Storage.Blobs.Models.CommitBlockListOptions options, System.Threading.CancellationToken cancellationToken = default);

abstract member CommitBlockListAsync : seq<string> * Azure.Storage.Blobs.Models.CommitBlockListOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>>
override this.CommitBlockListAsync : seq<string> * Azure.Storage.Blobs.Models.CommitBlockListOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>>

Public Overridable Function CommitBlockListAsync (base64BlockIds As IEnumerable(Of String), options As CommitBlockListOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of BlobContentInfo))

Parâmetros

base64BlockIds

IEnumerable<String>

Especifique as IDs de bloco codificadas em Base64 não confirmadas para indicar que o serviço blob deve pesquisar apenas a lista de blocos não confirmados para os blocos nomeados. Se o bloco não for encontrado na lista de blocos não confirmados, ele não será gravado como parte do blob e um RequestFailedException será gerado.

options

CommitBlockListOptions

Parâmetros opcionais.

cancellationToken

CancellationToken

Opcional CancellationToken para propagar notificações de que a operação deve ser cancelada.

Retornos

Task<Response<BlobContentInfo>>

Um Response<T> que descreve o estado do blob de blocos atualizado.

Comentários

Um RequestFailedException será gerado se ocorrer uma falha.