DataLakeFileClient.AppendAsync Método

Definição

Namespace:

Azure.Storage.Files.DataLake

Assembly:

Azure.Storage.Files.DataLake.dll

Pacote:

Azure.Storage.Files.DataLake v12.18.0

Origem:

DataLakeFileClient.cs

A AppendAsync(Stream, Int64, DataLakeFileAppendOptions, CancellationToken) operação carrega dados a serem acrescentados a um arquivo. Os dados só podem ser acrescentados a um arquivo. Para aplicar dados carregados anteriormente a um arquivo, chame Liberar Dados. No momento, o acréscimo está limitado a 4.000 MB por solicitação. Para carregar arquivos grandes de uma só vez, considere usar UploadAsync(Stream).

Para obter mais informações, consulte Atualizar Caminho.

public virtual System.Threading.Tasks.Task<Azure.Response> AppendAsync (System.IO.Stream content, long offset, Azure.Storage.Files.DataLake.Models.DataLakeFileAppendOptions options = default, System.Threading.CancellationToken cancellationToken = default);

abstract member AppendAsync : System.IO.Stream * int64 * Azure.Storage.Files.DataLake.Models.DataLakeFileAppendOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response>
override this.AppendAsync : System.IO.Stream * int64 * Azure.Storage.Files.DataLake.Models.DataLakeFileAppendOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response>

Public Overridable Function AppendAsync (content As Stream, offset As Long, Optional options As DataLakeFileAppendOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response)

Parâmetros

content

Stream

Um Stream que contém o conteúdo a ser carregado.

offset

Int64

Esse parâmetro permite que o chamador carregue dados em paralelo e controle a ordem na qual eles são acrescentados ao arquivo. É necessário ao carregar dados a serem acrescentados ao arquivo e ao liberar dados carregados anteriormente no arquivo. O valor deve ser a posição em que os dados devem ser acrescentados. Os dados carregados não são imediatamente liberados ou gravados no arquivo. Para liberar, os dados carregados anteriormente devem ser contíguos, o parâmetro position deve ser especificado e igual ao comprimento do arquivo depois que todos os dados tiverem sido gravados e não deve haver um corpo de entidade de solicitação incluído na solicitação.

options

DataLakeFileAppendOptions

Parâmetros opcionais.

cancellationToken

CancellationToken

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

Retornos

Task<Response>

Um Response que descreve o estado do arquivo atualizado.

Comentários

Um RequestFailedException será gerado se ocorrer uma falha.