DataLakeFileClient.Append 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 Append(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 Upload(Stream).

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

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

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

Public Overridable Function Append (content As Stream, offset As Long, Optional options As DataLakeFileAppendOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As 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 ele é acrescentado ao arquivo. É necessário ao carregar dados a serem acrescentados ao arquivo e ao liberar dados carregados anteriormente para o 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 de posição 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

Response

Um Response que descreve o estado do arquivo atualizado.

Comentários

Um RequestFailedException será gerado se ocorrer uma falha.