TaskOutputStorage.SaveTrackedAsync Méthode

Définition

Espace de noms:

Microsoft.Azure.Batch.Conventions.Files

Assembly:

Microsoft.Azure.Batch.Conventions.Files.dll

Paquet:

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

Surcharges

SaveTrackedAsync(String)	Enregistre le fichier spécifié dans le stockage persistant en tant TaskLogque , et effectue le suivi des ajouts suivants au fichier et les ajoute également à la copie persistante.
SaveTrackedAsync(TaskOutputKind, String, String, TimeSpan)	Enregistre le fichier spécifié dans le stockage persistant et effectue le suivi des ajouts suivants au fichier et les ajoute également à la copie persistante.

SaveTrackedAsync(String)

Source:

TaskOutputStorage.cs

Enregistre le fichier spécifié dans le stockage persistant en tant TaskLogque , et effectue le suivi des ajouts suivants au fichier et les ajoute également à la copie persistante.

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)

Paramètres

relativePath

String

Chemin d’accès du fichier à enregistrer par rapport au répertoire actif. Si le fichier se trouve dans un sous-répertoire du répertoire actif, le chemin d’accès relatif est conservé dans le stockage d’objets blob.

Retours

Task<ITrackedSaveOperation>

ITrackedSaveOperation qui enregistre un fichier dans le stockage d’objets blob et vide régulièrement les ajouts de fichier à l’objet blob jusqu’à ce qu’il soit supprimé. Lorsqu’ils sont supprimés, tous les ajouts restants sont vidés dans le stockage d’objets blob, et le suivi des ajouts de fichiers est arrêté.

Exceptions

ArgumentNullException

L’argument relativePath a la valeur null.

ArgumentException

L’argument relativePath est un chemin absolu ou est vide.

Remarques

Le suivi prend uniquement en charge les ajouts. Autrement dit, pendant le suivi d’un fichier, toutes les données ajoutées à la fin sont ajoutées au stockage persistant. Les modifications apportées aux données qui ont déjà été chargées ne seront pas reflétées dans le magasin persistant. Cette méthode est donc destinée à être utilisée uniquement avec des fichiers tels que des fichiers journaux (sans rotation) où les données sont ajoutées uniquement à la fin du fichier. Si l’intégralité du contenu d’un fichier peut changer, utilisez-le SaveAsync(TaskOutputKind, String, CancellationToken) et appelez-le régulièrement ou après chaque modification.

Si le fichier se trouve en dehors du répertoire actif, les traversées vers le haut de l’arborescence de répertoires sont supprimées. Par exemple, un relativePath de . \ProcessEnv.cmd » est traité comme « ProcessEnv.cmd » dans le but de créer un nom d’objet blob.

SaveTrackedAsync(TaskOutputKind, String, String, TimeSpan)

Source:

TaskOutputStorage.cs

Enregistre le fichier spécifié dans le stockage persistant et effectue le suivi des ajouts suivants au fichier et les ajoute également à la copie persistante.

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)

Paramètres

kind

TaskOutputKind

TaskOutputKind représentant la catégorie sous laquelle stocker ce fichier, par exemple TaskOutput ou TaskLog.

sourcePath

String

Chemin d’accès du fichier à enregistrer.

destinationRelativePath

String

Nom de l’objet blob sous lequel enregistrer le fichier. Cela peut inclure un composant relatif, tel que « pointclouds/pointcloud_0001.txt ».

flushInterval

TimeSpan

Intervalle auquel le vidage s’ajoute au stockage persistant.

Retours

Task<ITrackedSaveOperation>

ITrackedSaveOperation qui enregistre un fichier dans le stockage d’objets blob et vide régulièrement les ajouts de fichier à l’objet blob jusqu’à ce qu’il soit supprimé. Lorsqu’ils sont supprimés, tous les ajouts restants sont vidés dans le stockage d’objets blob, et le suivi des ajouts de fichiers est arrêté.

Exceptions

ArgumentNullException

L’argument kind, sourcePathou a destinationRelativePath la valeur null.

ArgumentException

L’argument sourcePath ou destinationRelativePath est vide.

Remarques

Le suivi prend uniquement en charge les ajouts. Autrement dit, pendant le suivi d’un fichier, toutes les données ajoutées à la fin sont ajoutées au stockage persistant. Les modifications apportées aux données qui ont déjà été chargées ne seront pas reflétées dans le magasin persistant. Cette méthode est donc destinée à être utilisée uniquement avec des fichiers tels que des fichiers journaux (sans rotation) où les données sont ajoutées uniquement à la fin du fichier. Si l’intégralité du contenu d’un fichier peut changer, utilisez-le SaveAsync(TaskOutputKind, String, String, CancellationToken) et appelez-le régulièrement ou après chaque modification.