CloudAppendBlob.AppendBlockAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
AppendBlockAsync(Stream, String)
Inicia uma operação assíncrona para confirmar um novo bloco de dados no final do blob.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync (System.IO.Stream blockData, string contentMD5 = default);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : System.IO.Stream * string -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : System.IO.Stream * string -> System.Threading.Tasks.Task<int64>
Public Overridable Function AppendBlockAsync (blockData As Stream, Optional contentMD5 As String = Nothing) As Task(Of Long)
Parâmetros
- contentMD5
- String
Um valor de hash opcional usado para garantir a integridade transacional. Pode ser null
ou uma cadeia de caracteres vazia.
Retornos
Um objeto Task que representa a operação assíncrona.
- Atributos
Comentários
Os clientes podem enviar o cabeçalho Content-MD5 para uma determinada operação de Bloco de Acréscimo como um meio de garantir a integridade transacional durante a transmissão. O contentMD5
parâmetro permite que os clientes que já têm acesso a um valor MD5 pré-computado para um determinado intervalo de bytes o forneçam. Se a BlobRequestOptions.UseTransactionalMd5 propriedade for definida true
como e o contentMD5
parâmetro for definido null
como , a biblioteca de clientes calculará o valor MD5 internamente.
Aplica-se a
AppendBlockAsync(Stream, String, CancellationToken)
Inicia uma operação assíncrona para confirmar um novo bloco de dados no final do blob.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync (System.IO.Stream blockData, string contentMD5, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : System.IO.Stream * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : System.IO.Stream * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
Public Overridable Function AppendBlockAsync (blockData As Stream, contentMD5 As String, cancellationToken As CancellationToken) As Task(Of Long)
Parâmetros
- contentMD5
- String
Um valor de hash opcional usado para garantir a integridade transacional. Pode ser null
ou uma cadeia de caracteres vazia.
- cancellationToken
- CancellationToken
Um CancellationToken a ser observado ao aguardar a conclusão da tarefa.
Retornos
Um objeto Task que representa a operação assíncrona.
- Atributos
Comentários
Os clientes podem enviar o cabeçalho Content-MD5 para uma determinada operação Put Block como um meio de garantir a integridade transacional pela transmissão. O contentMD5
parâmetro permite que os clientes que já têm acesso a um valor MD5 pré-computado para um determinado intervalo de bytes o forneçam. Se a BlobRequestOptions.UseTransactionalMd5 propriedade for definida true
como e o contentMD5
parâmetro for definido null
como , a biblioteca de clientes calculará o valor MD5 internamente.
Aplica-se a
AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext)
Inicia uma operação assíncrona para confirmar um novo bloco de dados no final do blob.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync (System.IO.Stream blockData, string contentMD5, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task<int64>
Public Overridable Function AppendBlockAsync (blockData As Stream, contentMD5 As String, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext) As Task(Of Long)
Parâmetros
- contentMD5
- String
Um valor de hash opcional usado para garantir a integridade transacional. Pode ser null
ou uma cadeia de caracteres vazia.
- accessCondition
- AccessCondition
Um objeto AccessCondition que representa a condição que deve ser atendida para que a solicitação continue. Se for null
, nenhuma condição é usada.
- options
- BlobRequestOptions
Um objeto BlobRequestOptions que especifica opções adicionais para a solicitação.
- operationContext
- OperationContext
Um objeto OperationContext que representa o contexto da operação atual.
Retornos
Um objeto Task que representa a operação assíncrona.
- Atributos
Comentários
Os clientes podem enviar o cabeçalho Content-MD5 para uma determinada operação de Bloco de Acréscimo como um meio de garantir a integridade transacional durante a transmissão. O contentMD5
parâmetro permite que os clientes que já têm acesso a um valor MD5 pré-computado para um determinado intervalo de bytes o forneçam. Se a BlobRequestOptions.UseTransactionalMd5 propriedade for definida true
como e o contentMD5
parâmetro for definido null
como , a biblioteca de clientes calculará o valor MD5 internamente.
Aplica-se a
AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)
Inicia uma operação assíncrona para confirmar um novo bloco de dados no final do blob.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync (System.IO.Stream blockData, string contentMD5, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
Public Overridable Function AppendBlockAsync (blockData As Stream, contentMD5 As String, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of Long)
Parâmetros
- contentMD5
- String
Um valor de hash opcional usado para garantir a integridade transacional. Pode ser null
ou uma cadeia de caracteres vazia.
- accessCondition
- AccessCondition
Um objeto AccessCondition que representa a condição que deve ser atendida para que a solicitação continue. Se for null
, nenhuma condição é usada.
- options
- BlobRequestOptions
Um objeto BlobRequestOptions que especifica opções adicionais para a solicitação.
- operationContext
- OperationContext
Um objeto OperationContext que representa o contexto da operação atual.
- cancellationToken
- CancellationToken
Um CancellationToken a ser observado ao aguardar a conclusão da tarefa.
Retornos
Um objeto Task que representa a operação assíncrona.
- Atributos
Comentários
Os clientes podem enviar o cabeçalho Content-MD5 para uma determinada operação de Bloco de Acréscimo como um meio de garantir a integridade transacional durante a transmissão. O contentMD5
parâmetro permite que os clientes que já têm acesso a um valor MD5 pré-computado para um determinado intervalo de bytes o forneçam. Se a BlobRequestOptions.UseTransactionalMd5 propriedade for definida true
como e o contentMD5
parâmetro for definido null
como , a biblioteca de clientes calculará o valor MD5 internamente.
Aplica-se a
AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext, IProgress<StorageProgress>, CancellationToken)
Inicia uma operação assíncrona para confirmar um novo bloco de dados no final do blob.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync (System.IO.Stream blockData, string contentMD5, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, IProgress<Microsoft.Azure.Storage.Core.Util.StorageProgress> progressHandler, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * IProgress<Microsoft.Azure.Storage.Core.Util.StorageProgress> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * IProgress<Microsoft.Azure.Storage.Core.Util.StorageProgress> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
Public Overridable Function AppendBlockAsync (blockData As Stream, contentMD5 As String, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, progressHandler As IProgress(Of StorageProgress), cancellationToken As CancellationToken) As Task(Of Long)
Parâmetros
- contentMD5
- String
Um valor de hash opcional usado para garantir a integridade transacional. Pode ser null
ou uma cadeia de caracteres vazia.
- accessCondition
- AccessCondition
Um objeto AccessCondition que representa a condição que deve ser atendida para que a solicitação continue. Se for null
, nenhuma condição é usada.
- options
- BlobRequestOptions
Um objeto BlobRequestOptions que especifica opções adicionais para a solicitação.
- operationContext
- OperationContext
Um objeto OperationContext que representa o contexto da operação atual.
- progressHandler
- IProgress<StorageProgress>
Um IProgress<T> objeto para manipular StorageProgress mensagens.
- cancellationToken
- CancellationToken
Um CancellationToken a ser observado ao aguardar a conclusão da tarefa.
Retornos
Um objeto Task que representa a operação assíncrona.
- Atributos
Comentários
Os clientes podem enviar o cabeçalho Content-MD5 para uma determinada operação de Bloco de Acréscimo como um meio de garantir a integridade transacional durante a transmissão. O contentMD5
parâmetro permite que os clientes que já têm acesso a um valor MD5 pré-computado para um determinado intervalo de bytes o forneçam. Se a BlobRequestOptions.UseTransactionalMd5 propriedade for definida true
como e o contentMD5
parâmetro for definido null
como , a biblioteca de clientes calculará o valor MD5 internamente.
Aplica-se a
AppendBlockAsync(Uri, Int64, Int64, String, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)
Confirma um novo bloco de dados no final do blob.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync (Uri sourceUri, long offset, long count, string sourceContentMd5, Microsoft.Azure.Storage.AccessCondition sourceAccessCondition, Microsoft.Azure.Storage.AccessCondition destAccessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : Uri * int64 * int64 * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : Uri * int64 * int64 * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
Public Overridable Function AppendBlockAsync (sourceUri As Uri, offset As Long, count As Long, sourceContentMd5 As String, sourceAccessCondition As AccessCondition, destAccessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of Long)
Parâmetros
- offset
- Int64
O deslocamento de bytes na origem na qual começar a recuperar o conteúdo.
- count
- Int64
O número de bytes da origem a ser retornada ou null
para retornar todos os bytes até o final do blob.
- sourceContentMd5
- String
Um valor de hash opcional que será usado para definir a ContentMD5 propriedade no blob. Pode ser null
ou uma cadeia de caracteres vazia.
- sourceAccessCondition
- AccessCondition
Um AccessCondition objeto que representa as condições de acesso para o blob de origem. Se for null
, nenhuma condição é usada.
- destAccessCondition
- AccessCondition
Um AccessCondition objeto que representa as condições de acesso para o blob de destino. Se for null
, nenhuma condição é usada.
- options
- BlobRequestOptions
Um objeto BlobRequestOptions que especifica opções adicionais para a solicitação.
- operationContext
- OperationContext
Um objeto OperationContext que representa o contexto da operação atual.
- cancellationToken
- CancellationToken
Um CancellationToken a ser observado ao aguardar a conclusão da tarefa.
Retornos
Um Task que representa uma ação assíncrona.
- Atributos
Aplica-se a
Azure SDK for .NET