TaskOutputStorage.SaveTrackedAsync Método

Definição

Namespace:

Microsoft.Azure.Batch.Conventions.Files

Assembly:

Microsoft.Azure.Batch.Conventions.Files.dll

Pacote:

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

Sobrecargas

SaveTrackedAsync(String)	Salva o arquivo especificado no armazenamento persistente como um TaskLoge rastreia os acréscimos subsequentes ao arquivo e os acrescenta à cópia persistente também.
SaveTrackedAsync(TaskOutputKind, String, String, TimeSpan)	Salva o arquivo especificado no armazenamento persistente e rastreia os acréscimos subsequentes ao arquivo e acrescenta-os à cópia persistente também.

SaveTrackedAsync(String)

Origem:

TaskOutputStorage.cs

Salva o arquivo especificado no armazenamento persistente como um TaskLoge rastreia os acréscimos subsequentes ao arquivo e os acrescenta à cópia persistente também.

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

O caminho do arquivo a ser salvo, em relação ao diretório atual. Se o arquivo estiver em um subdiretório do diretório atual, o caminho relativo será preservado no armazenamento de blobs.

Retornos

Task<ITrackedSaveOperation>

Um ITrackedSaveOperation que salvará um arquivo no armazenamento de blobs e liberará periodicamente os acréscimos de arquivos ao blob até serem descartados. Quando descartados, todos os acréscimos restantes são liberados para o armazenamento de blobs e o acompanhamento adicional de acréscimos de arquivos é interrompido.

Exceções

ArgumentNullException

O argumento relativePath é nulo.

ArgumentException

O relativePath argumento é um caminho absoluto ou está vazio.

Comentários

O acompanhamento dá suporte apenas a acréscimos. Ou seja, enquanto um arquivo está sendo rastreado, todos os dados adicionados no final são acrescentados ao armazenamento persistente. As alterações nos dados que já foram carregados não serão refletidas no repositório persistente. Portanto, esse método destina-se a ser usado somente com arquivos como arquivos de log (não rotativos), em que os dados são adicionados somente no final do arquivo. Se todo o conteúdo de um arquivo puder ser alterado, use SaveAsync(TaskOutputKind, String, CancellationToken) e chame-o periodicamente ou após cada alteração.

Se o arquivo estiver fora do diretório atual, as travessias até a árvore de diretório serão removidas. Por exemplo, um relativePath de ".. \ProcessEnv.cmd" seria tratado como "ProcessEnv.cmd" para fins de criação de um nome de blob.

SaveTrackedAsync(TaskOutputKind, String, String, TimeSpan)

Origem:

TaskOutputStorage.cs

Salva o arquivo especificado no armazenamento persistente e rastreia os acréscimos subsequentes ao arquivo e acrescenta-os à cópia persistente também.

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

Um TaskOutputKind que representa a categoria sob a qual armazenar esse arquivo, por exemplo TaskOutput , ou TaskLog.

sourcePath

String

O caminho do arquivo a ser salvo.

destinationRelativePath

String

O nome do blob no qual salvar o arquivo. Isso pode incluir um componente relativo, como "pointclouds/pointcloud_0001.txt".

flushInterval

TimeSpan

O intervalo no qual a liberação é acrescentada ao armazenamento persistente.

Retornos

Task<ITrackedSaveOperation>

Um ITrackedSaveOperation que salvará um arquivo no armazenamento de blobs e liberará periodicamente os acréscimos de arquivos ao blob até serem descartados. Quando descartados, todos os acréscimos restantes são liberados para o armazenamento de blobs e o acompanhamento adicional de acréscimos de arquivos é interrompido.

Exceções

ArgumentNullException

O kindargumento , sourcePathou destinationRelativePath é nulo.

ArgumentException

O sourcePath argumento ou destinationRelativePath está vazio.

Comentários

O acompanhamento dá suporte apenas a acréscimos. Ou seja, enquanto um arquivo está sendo rastreado, todos os dados adicionados no final são acrescentados ao armazenamento persistente. As alterações nos dados que já foram carregados não serão refletidas no repositório persistente. Portanto, esse método destina-se a ser usado somente com arquivos como arquivos de log (não rotativos), em que os dados são adicionados somente no final do arquivo. Se todo o conteúdo de um arquivo puder ser alterado, use SaveAsync(TaskOutputKind, String, String, CancellationToken) e chame-o periodicamente ou após cada alteração.