Freigeben über


TaskOutputStorage.SaveTrackedAsync Methode

Definition

Überlädt

SaveTrackedAsync(String)

Speichert die angegebene Datei als TaskLogpersistenten Speicher, verfolgt nachfolgende Anhänge an die Datei nach und fügt sie ebenfalls an die persistente Kopie an.

SaveTrackedAsync(TaskOutputKind, String, String, TimeSpan)

Speichert die angegebene Datei im persistenten Speicher, verfolgt nachfolgende Anhänge an die Datei nach und fügt sie ebenfalls an die persistente Kopie an.

SaveTrackedAsync(String)

Quelle:
TaskOutputStorage.cs

Speichert die angegebene Datei als TaskLogpersistenten Speicher, verfolgt nachfolgende Anhänge an die Datei nach und fügt sie ebenfalls an die persistente Kopie an.

public System.Threading.Tasks.Task<Microsoft.Azure.Batch.Conventions.Files.ITrackedSaveOperation> SaveTrackedAsync (string relativePath);
member this.SaveTrackedAsync : string -> System.Threading.Tasks.Task<Microsoft.Azure.Batch.Conventions.Files.ITrackedSaveOperation>
Public Function SaveTrackedAsync (relativePath As String) As Task(Of ITrackedSaveOperation)

Parameter

relativePath
String

Der Pfad der zu speichernden Datei relativ zum aktuellen Verzeichnis. Wenn sich die Datei in einem Unterverzeichnis des aktuellen Verzeichnisses befindet, wird der relative Pfad im Blobspeicher beibehalten.

Gibt zurück

Eine ITrackedSaveOperation , die eine Datei im Blobspeicher speichert und die Datei an das Blob anfügen wird, bis sie gelöscht wird. Wenn sie entfernt werden, werden alle verbleibenden Anhänge in den Blobspeicher geleert, und die weitere Nachverfolgung von Dateianfügevorgängen wird beendet.

Ausnahmen

Das relativePath-Argument ist null.

Das relativePath Argument ist ein absoluter Pfad oder ist leer.

Hinweise

Die Nachverfolgung unterstützt nur Anfügevorgänge. Das heißt, während eine Datei nachverfolgt wird, werden alle am Ende hinzugefügten Daten an den persistenten Speicher angefügt. Änderungen an daten, die bereits hochgeladen wurden, werden nicht in den persistenten Speicher übernommen. Diese Methode ist daher nur für die Verwendung mit Dateien wie (nicht rotierenden) Protokolldateien vorgesehen, bei denen Daten nur am Ende der Datei hinzugefügt werden. Wenn sich der gesamte Inhalt einer Datei ändern kann, verwenden SaveAsync(TaskOutputKind, String, CancellationToken) Und rufen Sie sie regelmäßig oder nach jeder Änderung auf.

Wenn sich die Datei außerhalb des aktuellen Verzeichnisses befindet, wird die Verzeichnisstruktur entfernt. Beispiel: ein relativePath von ".. \ProcessEnv.cmd" wird zum Erstellen eines Blobnamens als "ProcessEnv.cmd" behandelt.

Gilt für:

SaveTrackedAsync(TaskOutputKind, String, String, TimeSpan)

Quelle:
TaskOutputStorage.cs

Speichert die angegebene Datei im persistenten Speicher, verfolgt nachfolgende Anhänge an die Datei nach und fügt sie ebenfalls an die persistente Kopie an.

public System.Threading.Tasks.Task<Microsoft.Azure.Batch.Conventions.Files.ITrackedSaveOperation> SaveTrackedAsync (Microsoft.Azure.Batch.Conventions.Files.TaskOutputKind kind, string sourcePath, string destinationRelativePath, TimeSpan flushInterval);
member this.SaveTrackedAsync : Microsoft.Azure.Batch.Conventions.Files.TaskOutputKind * string * string * TimeSpan -> System.Threading.Tasks.Task<Microsoft.Azure.Batch.Conventions.Files.ITrackedSaveOperation>
Public Function SaveTrackedAsync (kind As TaskOutputKind, sourcePath As String, destinationRelativePath As String, flushInterval As TimeSpan) As Task(Of ITrackedSaveOperation)

Parameter

kind
TaskOutputKind

Eine TaskOutputKind , die die Kategorie darstellt, in der diese Datei gespeichert werden soll, z. B TaskOutput . oder TaskLog.

sourcePath
String

Der Pfad der zu speichernden Datei.

destinationRelativePath
String

Der Blobname, unter dem die Datei gespeichert werden soll. Dies kann eine relative Komponente wie "pointclouds/pointcloud_0001.txt" enthalten.

flushInterval
TimeSpan

Das Intervall, in dem geleert werden soll, wird an persistenten Speicher angefügt.

Gibt zurück

Eine ITrackedSaveOperation , die eine Datei im Blobspeicher speichert und die Datei an das Blob anfügen wird, bis sie gelöscht wird. Wenn sie entfernt werden, werden alle verbleibenden Anhänge in den Blobspeicher geleert, und die weitere Nachverfolgung von Dateianfügevorgängen wird beendet.

Ausnahmen

Das kindArgument , sourcePath, oder destinationRelativePath ist NULL.

Das sourcePath Argument oder destinationRelativePath ist leer.

Hinweise

Die Nachverfolgung unterstützt nur Anfügevorgänge. Das heißt, während eine Datei nachverfolgt wird, werden alle am Ende hinzugefügten Daten an den persistenten Speicher angefügt. Änderungen an daten, die bereits hochgeladen wurden, werden nicht in den persistenten Speicher übernommen. Diese Methode ist daher nur für die Verwendung mit Dateien wie (nicht rotierenden) Protokolldateien vorgesehen, bei denen Daten nur am Ende der Datei hinzugefügt werden. Wenn sich der gesamte Inhalt einer Datei ändern kann, verwenden SaveAsync(TaskOutputKind, String, String, CancellationToken) Und rufen Sie sie regelmäßig oder nach jeder Änderung auf.

Gilt für: