TaskOutputStorage.SaveTrackedAsync Método

Definición

Espacio de nombres:

Microsoft.Azure.Batch.Conventions.Files

Ensamblado:

Microsoft.Azure.Batch.Conventions.Files.dll

Paquete:

Microsoft.Azure.Batch.Conventions.Files v4.0.0

Sobrecargas

SaveTrackedAsync(String)	Guarda el archivo especificado en el almacenamiento persistente como TaskLogy realiza un seguimiento de los anexos posteriores al archivo y los anexa a la copia persistente.
SaveTrackedAsync(TaskOutputKind, String, String, TimeSpan)	Guarda el archivo especificado en el almacenamiento persistente y realiza un seguimiento de los anexos posteriores al archivo y los anexa a la copia persistente.

SaveTrackedAsync(String)

Source:

TaskOutputStorage.cs

Guarda el archivo especificado en el almacenamiento persistente como TaskLogy realiza un seguimiento de los anexos posteriores al archivo y los anexa a la copia persistente.

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)

Parámetros

relativePath

String

Ruta de acceso del archivo que se va a guardar, en relación con el directorio actual. Si el archivo está en un subdirectorio del directorio actual, la ruta de acceso relativa se conservará en Blob Storage.

Devoluciones

Task<ITrackedSaveOperation>

Que ITrackedSaveOperation guardará un archivo en Blob Storage y vaciará periódicamente los anexos de archivos en el blob hasta que se elimine. Cuando se elimina, se vacían todos los anexos restantes en Blob Storage y se detiene el seguimiento adicional de los anexos de archivos.

Excepciones

ArgumentNullException

El argumento relativePath es null.

ArgumentException

El relativePath argumento es una ruta de acceso absoluta o está vacía.

Comentarios

El seguimiento solo admite anexos. Es decir, mientras se realiza un seguimiento de un archivo, los datos agregados al final se anexan al almacenamiento persistente. Los cambios en los datos que ya se han cargado no se reflejarán en el almacén persistente. Por lo tanto, este método está pensado para su uso solo con archivos de registro (sin rotación), donde los datos solo se agregan al final del archivo. Si todo el contenido de un archivo puede cambiar, úselo SaveAsync(TaskOutputKind, String, CancellationToken) y llámelo periódicamente o después de cada cambio.

Si el archivo está fuera del directorio actual, se quitan los recorridos hacia arriba del árbol de directorios. Por ejemplo, un relativePath de ".. \ProcessEnv.cmd" se trataría como "ProcessEnv.cmd" para crear un nombre de blob.

SaveTrackedAsync(TaskOutputKind, String, String, TimeSpan)

Source:

TaskOutputStorage.cs

Guarda el archivo especificado en el almacenamiento persistente y realiza un seguimiento de los anexos posteriores al archivo y los anexa a la copia persistente.

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)

Parámetros

kind

TaskOutputKind

que TaskOutputKind representa la categoría en la que se va a almacenar este archivo, por ejemplo TaskOutput o TaskLog.

sourcePath

String

Ruta de acceso del archivo que se va a guardar.

destinationRelativePath

String

Nombre del blob en el que se va a guardar el archivo. Esto puede incluir un componente relativo, como "pointclouds/pointcloud_0001.txt".

flushInterval

TimeSpan

Intervalo en el que se va a vaciar los anexos al almacenamiento persistente.

Devoluciones

Task<ITrackedSaveOperation>

Que ITrackedSaveOperation guardará un archivo en Blob Storage y vaciará periódicamente los anexos de archivos en el blob hasta que se elimine. Cuando se elimina, se vacían todos los anexos restantes en Blob Storage y se detiene el seguimiento adicional de los anexos de archivos.

Excepciones

ArgumentNullException

El kindargumento , sourcePatho destinationRelativePath es NULL.

ArgumentException

El sourcePath argumento o destinationRelativePath está vacío.

Comentarios

El seguimiento solo admite anexos. Es decir, mientras se realiza un seguimiento de un archivo, los datos agregados al final se anexan al almacenamiento persistente. Los cambios en los datos que ya se han cargado no se reflejarán en el almacén persistente. Por lo tanto, este método está pensado para su uso solo con archivos de registro (sin rotación), donde los datos solo se agregan al final del archivo. Si todo el contenido de un archivo puede cambiar, úselo SaveAsync(TaskOutputKind, String, String, CancellationToken) y llámelo periódicamente o después de cada cambio.