你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

TaskOutputStorage.SaveTrackedAsync 方法

定义

命名空间:

Microsoft.Azure.Batch.Conventions.Files

程序集:

Microsoft.Azure.Batch.Conventions.Files.dll

包:

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

重载

SaveTrackedAsync(String)	将指定的文件作为 TaskLog保存到永久性存储中，并跟踪文件的后续追加，并将它们追加到持久副本。
SaveTrackedAsync(TaskOutputKind, String, String, TimeSpan)	将指定的文件保存到永久性存储，并跟踪文件的后续追加，并将它们追加到永久性副本。

SaveTrackedAsync(String)

Source:

TaskOutputStorage.cs

将指定的文件作为 TaskLog保存到永久性存储中，并跟踪文件的后续追加，并将它们追加到持久副本。

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)

参数

relativePath

String

要保存的文件相对于当前目录的路径。 如果文件位于当前目录的子目录中，则相对路径将保留在 Blob 存储中。

返回

Task<ITrackedSaveOperation>

一个 ， ITrackedSaveOperation 它将文件保存到 Blob 存储，并定期刷新追加到 Blob 的文件，直到释放。 释放后，所有剩余的追加都会刷新到 Blob 存储，并停止对文件追加的进一步跟踪。

例外

ArgumentNullException

relativePath 参数为 null。

ArgumentException

参数 relativePath 是绝对路径，或为空。

注解

跟踪仅支持追加。 也就是说，在跟踪文件时，在末尾添加的任何数据将追加到永久性存储。 对已上传的数据所做的更改不会反映在永久性存储中。 因此，此方法仅用于 (非旋转) 日志文件等文件，其中数据仅在文件末尾添加。 如果文件的全部内容可以更改，请使用 SaveAsync(TaskOutputKind, String, CancellationToken) 并定期或在每次更改后调用它。

如果文件在当前目录之外，则删除目录树向上遍历。 例如，的 relativePath “..\ProcessEnv.cmd“将被视为”ProcessEnv.cmd“，以便创建 Blob 名称。

SaveTrackedAsync(TaskOutputKind, String, String, TimeSpan)

Source:

TaskOutputStorage.cs

将指定的文件保存到永久性存储，并跟踪文件的后续追加，并将它们追加到永久性副本。

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)

参数

kind

TaskOutputKind

一个 TaskOutputKind ，表示存储此文件的类别，例如 TaskOutput 或 TaskLog。

sourcePath

String

要保存的文件的路径。

destinationRelativePath

String

保存文件的 Blob 名称。 这可能包括相对组件，例如“pointclouds/pointcloud_0001.txt”。

flushInterval

TimeSpan

刷新追加到永久性存储的时间间隔。

返回

Task<ITrackedSaveOperation>

一个 ， ITrackedSaveOperation 它将文件保存到 Blob 存储，并定期刷新追加到 Blob 的文件，直到释放。 释放后，所有剩余的追加都会刷新到 Blob 存储，并停止对文件追加的进一步跟踪。

例外

ArgumentNullException

kind、 sourcePath或 destinationRelativePath 参数为 null。

ArgumentException

sourcePath或 destinationRelativePath 参数为空。

注解

跟踪仅支持追加。 也就是说，在跟踪文件时，在末尾添加的任何数据将追加到永久性存储。 对已上传的数据所做的更改不会反映在永久性存储中。 因此，此方法仅用于 (非旋转) 日志文件等文件，其中数据仅在文件末尾添加。 如果文件的全部内容可以更改，请使用 SaveAsync(TaskOutputKind, String, String, CancellationToken) 并定期或在每次更改后调用它。