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

CloudJob.AddTaskAsync 方法

定义

命名空间:

Microsoft.Azure.Batch

程序集:

Microsoft.Azure.Batch.dll

包:

Microsoft.Azure.Batch v16.0.0

重载

AddTaskAsync(CloudTask, ConcurrentDictionary<Type,IFileStagingArtifact>, IEnumerable<BatchClientBehavior>, CancellationToken)	将单个任务添加到此 CloudJob。 若要添加多个任务，请使用 JobOperations.AddTaskAsync。
AddTaskAsync(IEnumerable<CloudTask>, BatchClientParallelOptions, ConcurrentBag<ConcurrentDictionary<Type,IFileStagingArtifact>>, Nullable<TimeSpan>, IEnumerable<BatchClientBehavior>)	将任务添加到作业。

AddTaskAsync(CloudTask, ConcurrentDictionary<Type,IFileStagingArtifact>, IEnumerable<BatchClientBehavior>, CancellationToken)

将单个任务添加到此 CloudJob。 若要添加多个任务，请使用 JobOperations.AddTaskAsync。

public System.Threading.Tasks.Task AddTaskAsync (Microsoft.Azure.Batch.CloudTask taskToAdd, System.Collections.Concurrent.ConcurrentDictionary<Type,Microsoft.Azure.Batch.IFileStagingArtifact> allFileStagingArtifacts = default, System.Collections.Generic.IEnumerable<Microsoft.Azure.Batch.BatchClientBehavior> additionalBehaviors = default, System.Threading.CancellationToken cancellationToken = default);

member this.AddTaskAsync : Microsoft.Azure.Batch.CloudTask * System.Collections.Concurrent.ConcurrentDictionary<Type, Microsoft.Azure.Batch.IFileStagingArtifact> * seq<Microsoft.Azure.Batch.BatchClientBehavior> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function AddTaskAsync (taskToAdd As CloudTask, Optional allFileStagingArtifacts As ConcurrentDictionary(Of Type, IFileStagingArtifact) = Nothing, Optional additionalBehaviors As IEnumerable(Of BatchClientBehavior) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

参数

taskToAdd

CloudTask

要添加的 CloudTask。

allFileStagingArtifacts

ConcurrentDictionary<Type,IFileStagingArtifact>

一个可选集合，用于自定义和接收有关文件暂存过程的信息， (请参阅 FilesToStage) 。 有关更多信息，请参见IFileStagingArtifact。

additionalBehaviors

IEnumerable<BatchClientBehavior>

应用于 之后的 Batch 服务请求的实例集合BatchClientBehaviorCustomBehaviors。

cancellationToken

CancellationToken

一个 CancellationToken ，用于控制异步操作的生存期。

返回

Task

表示异步操作的 Task。

注解

每次调用此方法都会引发对 Batch 服务的请求。 因此，使用此方法添加多个任务的效率低于使用批量添加方法，并可能导致 HTTP 连接限制。 如果并行执行其中许多操作，并且看到客户端超时 (TaskCanceledException) ，请参阅 http://msdn.microsoft.com/en-us/library/system.net.servicepointmanager.defaultconnectionlimit%28v=vs.110%29.aspx 或使用 AddTaskAsync(String, IEnumerable<CloudTask>, BatchClientParallelOptions, ConcurrentBag<ConcurrentDictionary<Type,IFileStagingArtifact>>, Nullable<TimeSpan>, IEnumerable<BatchClientBehavior>)。

添加任务操作以异步方式运行。

AddTaskAsync(IEnumerable<CloudTask>, BatchClientParallelOptions, ConcurrentBag<ConcurrentDictionary<Type,IFileStagingArtifact>>, Nullable<TimeSpan>, IEnumerable<BatchClientBehavior>)

将任务添加到作业。

public System.Threading.Tasks.Task AddTaskAsync (System.Collections.Generic.IEnumerable<Microsoft.Azure.Batch.CloudTask> tasksToAdd, Microsoft.Azure.Batch.BatchClientParallelOptions parallelOptions = default, System.Collections.Concurrent.ConcurrentBag<System.Collections.Concurrent.ConcurrentDictionary<Type,Microsoft.Azure.Batch.IFileStagingArtifact>> fileStagingArtifacts = default, TimeSpan? timeout = default, System.Collections.Generic.IEnumerable<Microsoft.Azure.Batch.BatchClientBehavior> additionalBehaviors = default);

member this.AddTaskAsync : seq<Microsoft.Azure.Batch.CloudTask> * Microsoft.Azure.Batch.BatchClientParallelOptions * System.Collections.Concurrent.ConcurrentBag<System.Collections.Concurrent.ConcurrentDictionary<Type, Microsoft.Azure.Batch.IFileStagingArtifact>> * Nullable<TimeSpan> * seq<Microsoft.Azure.Batch.BatchClientBehavior> -> System.Threading.Tasks.Task

Public Function AddTaskAsync (tasksToAdd As IEnumerable(Of CloudTask), Optional parallelOptions As BatchClientParallelOptions = Nothing, Optional fileStagingArtifacts As ConcurrentBag(Of ConcurrentDictionary(Of Type, IFileStagingArtifact)) = Nothing, Optional timeout As Nullable(Of TimeSpan) = Nothing, Optional additionalBehaviors As IEnumerable(Of BatchClientBehavior) = Nothing) As Task

参数

tasksToAdd

IEnumerable<CloudTask>

要添加的 CloudTask。

parallelOptions

BatchClientParallelOptions

控制同时向 Batch 服务发出的并行 AddTaskCollection 请求数。 每个 AddTaskCollection 请求最多 MaxTasksInSingleAddTaskCollectionRequest 包含任务。 还控制操作的取消标记。 如果省略，则使用默认值 (请参阅 BatchClientParallelOptions.)

fileStagingArtifacts

ConcurrentBag<ConcurrentDictionary<Type,IFileStagingArtifact>>

用于接收有关文件暂存过程的信息的可选集合 (请参阅 FilesToStage) 。 对于每组要提交到 Batch 服务的任务，都会向 添加 ConcurrentBag<T> 一个条目。 与单任务添加不同，不能使用此参数自定义文件暂存过程。 有关每个条目的格式的详细信息，请参阅 IFileStagingArtifact。

timeout

Nullable<TimeSpan>

操作超时的时间量。

additionalBehaviors

IEnumerable<BatchClientBehavior>

应用于 之后的 Batch 服务请求的实例集合BatchClientBehaviorCustomBehaviors。

返回

Task

表示异步操作的 Task 对象。

例外

ParallelOperationsException

如果对 Batch 服务的一个或多个请求失败，则引发。

注解

添加任务操作以异步方式运行。

此方法不是原子的;也就是说， 方法可能会开始添加任务，然后失败。 要添加的任务集合最多 MaxTasksInSingleAddTaskCollectionRequest细分为大小区块，并为每个区块发出 AddTaskCollection 请求。 可以根据 并行发出 parallelOptions请求。

同时向 Batch 服务发出大量请求可能会导致 HTTP 连接限制。 如果在并行 (执行其中许多操作，或者在 parallelOptions) 中指定了较大的 MaxDegreeOfParallelism，并且看到客户端超时 (TaskCanceledException) ，请参阅 http://msdn.microsoft.com/en-us/library/system.net.servicepointmanager.defaultconnectionlimit%28v=vs.110%29.aspx 。

遇到错误时操作的进度由 AddTaskCollectionResultHandler 行为决定。 通常不需要指定此行为，因为 Batch 客户端使用在正常情况下工作的默认值。 如果确实要自定义此行为，请在 或 additionalBehaviors 集合中CustomBehaviors指定 AddTaskCollectionResultHandler。