你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
TaskOutputStorage.SaveTrackedAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| 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 存储中。
返回
一个 ， ITrackedSaveOperation 它将文件保存到 Blob 存储，并定期刷新追加到 Blob 的文件，直到释放。 释放后，所有剩余的追加都会刷新到 Blob 存储，并停止对文件追加的进一步跟踪。
例外
relativePath 参数为 null。
参数 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
刷新追加到永久性存储的时间间隔。
返回
一个 ， ITrackedSaveOperation 它将文件保存到 Blob 存储，并定期刷新追加到 Blob 的文件，直到释放。 释放后，所有剩余的追加都会刷新到 Blob 存储，并停止对文件追加的进一步跟踪。
例外
kind、 sourcePath或 destinationRelativePath 参数为 null。
sourcePath或 destinationRelativePath 参数为空。
注解
跟踪仅支持追加。 也就是说，在跟踪文件时，在末尾添加的任何数据将追加到永久性存储。 对已上传的数据所做的更改不会反映在永久性存储中。 因此，此方法仅用于 (非旋转) 日志文件等文件，其中数据仅在文件末尾添加。 如果文件的全部内容可以更改，请使用 SaveAsync(TaskOutputKind, String, String, CancellationToken) 并定期或在每次更改后调用它。
