DataLakeFileClient.Append Methode

Definition

Namespace:

Azure.Storage.Files.DataLake

Assembly:

Azure.Storage.Files.DataLake.dll

Paket:

Azure.Storage.Files.DataLake v12.18.0

Quelle:

DataLakeFileClient.cs

Der Append(Stream, Int64, DataLakeFileAppendOptions, CancellationToken) Vorgang lädt Daten hoch, die an eine Datei angefügt werden sollen. Daten können nur an eine Datei angefügt werden. Um zuvor hochgeladene Daten auf eine Datei anzuwenden, rufen Sie Flush Data auf. Append ist derzeit auf 4.000 MB pro Anforderung beschränkt. Um große Dateien gleichzeitig hochzuladen, sollten Sie verwenden Upload(Stream).

Weitere Informationen finden Sie unter Pfad aktualisieren.

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

Parameter

content

Stream

Ein Stream , der den hochzuladenden Inhalt enthält.

offset

Int64

Dieser Parameter ermöglicht es dem Aufrufer, Daten parallel hochzuladen und die Reihenfolge zu steuern, in der sie an die Datei angefügt werden. Dies ist beim Hochladen von Daten erforderlich, die an die Datei angefügt werden müssen, und wenn zuvor hochgeladene Daten in die Datei geleert werden. Der Wert muss die Position sein, an der die Daten angefügt werden sollen. Hochgeladene Daten werden nicht sofort geleert oder in die Datei geschrieben. Zum Leeren müssen die zuvor hochgeladenen Daten zusammenhängend sein, der Positionsparameter muss angegeben werden und der Länge der Datei entsprechen, nachdem alle Daten geschrieben wurden, und es darf kein Anforderungsentitätstext in der Anforderung enthalten sein.

options

DataLakeFileAppendOptions

Optionale Parameter.

cancellationToken

CancellationToken

Optional CancellationToken zur Weitergabe von Benachrichtigungen, dass der Vorgang abgebrochen werden soll.

Gibt zurück

Response

Eine Response , die den Status der aktualisierten Datei beschreibt.

Hinweise

Ein RequestFailedException wird ausgelöst, wenn ein Fehler auftritt.