JobOperations.AddTaskAsync Méthode

Définition

Espace de noms:

Microsoft.Azure.Batch

Assembly:

Microsoft.Azure.Batch.dll

Paquet:

Microsoft.Azure.Batch v16.2.0

Surcharges

AddTaskAsync(String, CloudTask, ConcurrentDictionary<Type,IFileStagingArtifact>, IEnumerable<BatchClientBehavior>, CancellationToken)	Ajoute une seule tâche à un travail. Pour ajouter plusieurs tâches, utilisez JobOperations.AddTaskAsync.
AddTaskAsync(String, IEnumerable<CloudTask>, BatchClientParallelOptions, ConcurrentBag<ConcurrentDictionary<Type,IFileStagingArtifact>>, Nullable<TimeSpan>, IEnumerable<BatchClientBehavior>)	Ajoute des tâches à un travail.

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

Source:

JobOperations.cs

Ajoute une seule tâche à un travail. Pour ajouter plusieurs tâches, utilisez JobOperations.AddTaskAsync.

public System.Threading.Tasks.Task AddTaskAsync (string jobId, 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 : string * 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 (jobId As String, 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

Paramètres

jobId

String

ID du travail auquel ajouter la tâche.

taskToAdd

CloudTask

CloudTask à ajouter.

allFileStagingArtifacts

ConcurrentDictionary<Type,IFileStagingArtifact>

Collection facultative pour personnaliser et recevoir des informations sur le processus de préproduction de fichiers (voir FilesToStage). Pour plus d'informations, consultez IFileStagingArtifact.

additionalBehaviors

IEnumerable<BatchClientBehavior>

Collection d’instances BatchClientBehavior appliquées à la demande de service Batch après le CustomBehaviors.

cancellationToken

CancellationToken

CancellationToken pour contrôler la durée de vie de l’opération asynchrone.

Retours

Task

Objet Task qui représente l’opération asynchrone.

Remarques

Chaque appel à cette méthode entraîne une demande adressée au service Batch. Par conséquent, l’utilisation de cette méthode pour ajouter plusieurs tâches est moins efficace que l’utilisation d’une méthode d’ajout en bloc et peut entraîner des restrictions de connexion HTTP. Si vous effectuez un grand nombre de ces opérations en parallèle et que vous voyez des délais d’expiration côté client, consultez http://msdn.microsoft.com/en-us/library/system.net.servicepointmanager.defaultconnectionlimit%28v=vs.110%29.aspx ou utilisez la surcharge à plusieurs tâches d’AddTaskAsync.

L’opération d’ajout de tâche s’exécute de manière asynchrone.

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

Source:

JobOperations.cs

Ajoute des tâches à un travail.

public System.Threading.Tasks.Task AddTaskAsync (string jobId, 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 : string * 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 (jobId As String, 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

Paramètres

jobId

String

ID du travail auquel ajouter les tâches.

tasksToAdd

IEnumerable<CloudTask>

CloudTask à ajouter.

parallelOptions

BatchClientParallelOptions

Contrôle le nombre de requêtes AddTaskCollection simultanées émises pour le service Batch. Chaque requête AddTaskCollection contient au maximum les MaxTasksInSingleAddTaskCollectionRequest tâches qu’elle contient. Contrôle également le jeton d’annulation de l’opération. En cas d’omission, la valeur par défaut est utilisée (voir BatchClientParallelOptions.)

fileStagingArtifacts

ConcurrentBag<ConcurrentDictionary<Type,IFileStagingArtifact>>

Collection facultative pour recevoir des informations sur le processus de préproduction de fichiers (voir FilesToStage). Une entrée est ajoutée au ConcurrentBag<T> pour chaque ensemble de tâches regroupées pour soumission au service Batch. Contrairement aux ajouts à tâche unique, vous ne pouvez pas utiliser ce paramètre pour personnaliser le processus de préproduction de fichiers. Pour plus d’informations sur le format de chaque entrée, consultez IFileStagingArtifact.

timeout

Nullable<TimeSpan>

Durée après laquelle l’opération expire.

additionalBehaviors

IEnumerable<BatchClientBehavior>

Collection d’instances BatchClientBehavior appliquées à la demande de service Batch après le CustomBehaviors.

Retours

Task

Objet Task qui représente l’opération asynchrone.

Exceptions

ParallelOperationsException

Levée si une ou plusieurs demandes adressées au service Batch échouent.

Remarques

L’opération d’ajout de tâche s’exécute de manière asynchrone.

Cette méthode n’est pas atomique ; autrement dit, il est possible pour la méthode de commencer à ajouter des tâches, puis d’échouer. La collection de tâches à ajouter est divisée en blocs de taille au maximum MaxTasksInSingleAddTaskCollectionRequestet une requête AddTaskCollection est émise pour chaque segment. Les demandes peuvent être émises en parallèle en fonction de .parallelOptions

L’émission d’un grand nombre de requêtes simultanées au service Batch peut entraîner des restrictions de connexion HTTP. Si vous effectuez la plupart de ces opérations en parallèle (ou si vous avez spécifié un grand MaxDegreeOfParallelism dans parallelOptions) et que vous voyez des délais d’expiration côté client, consultez http://msdn.microsoft.com/en-us/library/system.net.servicepointmanager.defaultconnectionlimit%28v=vs.110%29.aspx .

La progression de l’opération face aux erreurs est déterminée par AddTaskCollectionResultHandler le comportement. Normalement, vous n’avez pas besoin de spécifier ce comportement, car le client Batch utilise une valeur par défaut qui fonctionne dans des circonstances normales. Si vous souhaitez personnaliser ce comportement, spécifiez un AddTaskCollectionResultHandler dans les CustomBehaviors collections ou additionalBehaviors .