TaskOutputStorage.SaveTrackedAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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
L’argument relativePath a la valeur null.
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.
S’applique à
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
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
L’argument kind, sourcePathou a destinationRelativePath la valeur null.
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.
S’applique à
Azure SDK for .NET