Freigeben über


DataLakeFileClient.Append Methode

Definition

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

Eine Response , die den Status der aktualisierten Datei beschreibt.

Hinweise

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

Gilt für: