IFileSystemOperations.AppendWithHttpMessagesAsync Método

Definição

Usado para acréscimos seriais ao arquivo especificado. OBSERVAÇÃO: o destino não deve conter dados adicionados por ConcurrentAppend. ConcurrentAppend e Append não podem ser usados de forma intercambiável; depois que um arquivo de destino tiver sido modificado usando qualquer uma dessas opções de acréscimo, a outra opção de acréscimo não poderá ser usada no arquivo de destino.

public System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse> AppendWithHttpMessagesAsync (string accountName, string directFilePath, System.IO.Stream streamContents, long? offset = default, Microsoft.Azure.Management.DataLake.Store.Models.SyncFlag? syncFlag = default, Guid? leaseId = default, Guid? fileSessionId = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);
public System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse> AppendWithHttpMessagesAsync (string accountName, string path, System.IO.Stream streamContents, long? offset = default, Microsoft.Azure.Management.DataLake.Store.Models.SyncFlag? syncFlag = default, Guid? leaseId = default, Guid? fileSessionId = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);
abstract member AppendWithHttpMessagesAsync : string * string * System.IO.Stream * Nullable<int64> * Nullable<Microsoft.Azure.Management.DataLake.Store.Models.SyncFlag> * Nullable<Guid> * Nullable<Guid> * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse>
abstract member AppendWithHttpMessagesAsync : string * string * System.IO.Stream * Nullable<int64> * Nullable<Microsoft.Azure.Management.DataLake.Store.Models.SyncFlag> * Nullable<Guid> * Nullable<Guid> * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse>
Public Function AppendWithHttpMessagesAsync (accountName As String, directFilePath As String, streamContents As Stream, Optional offset As Nullable(Of Long) = Nothing, Optional syncFlag As Nullable(Of SyncFlag) = Nothing, Optional leaseId As Nullable(Of Guid) = Nothing, Optional fileSessionId As Nullable(Of Guid) = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of AzureOperationResponse)
Public Function AppendWithHttpMessagesAsync (accountName As String, path As String, streamContents As Stream, Optional offset As Nullable(Of Long) = Nothing, Optional syncFlag As Nullable(Of SyncFlag) = Nothing, Optional leaseId As Nullable(Of Guid) = Nothing, Optional fileSessionId As Nullable(Of Guid) = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of AzureOperationResponse)

Parâmetros

accountName
String

A conta do Azure Data Lake Store na qual executar operações do sistema de arquivos.

directFilePathpath
String

O caminho do Data Lake Store (começando com '/') do arquivo ao qual acrescentar.

streamContents
Stream

O conteúdo do arquivo a ser incluído ao acrescentar ao arquivo.

offset
Nullable<Int64>

O deslocamento opcional no fluxo para iniciar a operação de acréscimo. O padrão é acrescentar no final do fluxo.

syncFlag
Nullable<SyncFlag>

Opcionalmente, indica o que fazer após a conclusão do acréscimo simultâneo. DATA indica que mais dados serão enviados imediatamente pelo cliente, o identificador de arquivo deve permanecer aberto/bloqueado e os metadados de arquivo (incluindo o comprimento do arquivo, hora da última modificação) NÃO devem ser atualizados. METADADOS indica que mais dados serão enviados imediatamente pelo cliente, o identificador de arquivo deve permanecer aberto/bloqueado e os metadados de arquivo devem ser atualizados. CLOSE indica que o cliente terminou de enviar dados, o identificador de arquivo deve ser fechado/desbloqueado e os metadados de arquivo devem ser atualizados. Os valores possíveis incluem: 'DATA', 'METADATA', 'CLOSE'

leaseId
Nullable<Guid>

GUID exclusivo opcional por arquivo para garantir a semântica de gravador único, o que significa que somente os clientes que acrescentam ao arquivo com a mesma leaseId terão permissão para fazê-lo.

fileSessionId
Nullable<Guid>

GUID exclusivo opcional por arquivo que indica que todos os acréscimos com o mesmo fileSessionId são do mesmo cliente e da mesma sessão. Isso dará um benefício de desempenho quando syncFlag for DATA ou METADATA.

customHeaders
Dictionary<String,List<String>>

Os cabeçalhos que serão adicionados à solicitação.

cancellationToken
CancellationToken

O token de cancelamento.

Retornos

Exceções

Gerado quando a operação retornou um código de status inválido

Gerado quando um parâmetro necessário é nulo

Aplica-se a