SPWorkflowManager.StartWorkflow - Méthode (SPListItem, SPWorkflowAssociation, String)

Article
05/11/2015

Crée et démarre une nouvelle instance de flux de travail sur un élément de liste spécifié, basé sur une association de flux de travail spécifié, avec les paramètres d'événement spécifiés.

Espace de noms : Microsoft.SharePoint.Workflow
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
Public Function StartWorkflow ( _
    item As SPListItem, _
    association As SPWorkflowAssociation, _
    eventData As String _
) As SPWorkflow
'Utilisation
Dim instance As SPWorkflowManager
Dim item As SPListItem
Dim association As SPWorkflowAssociation
Dim eventData As String
Dim returnValue As SPWorkflow

returnValue = instance.StartWorkflow(item, _
    association, eventData)

public SPWorkflow StartWorkflow(
    SPListItem item,
    SPWorkflowAssociation association,
    string eventData
)

Paramètres

item
Type : Microsoft.SharePoint.SPListItem

L'élément de liste auquel démarrer l'instance de workflow.

association
Type : Microsoft.SharePoint.Workflow.SPWorkflowAssociation

L'association de flux de travail sur lequel baser la nouvelle instance de flux de travail.

eventData
Type : System.String

Chaîne qui contient les paramètres d'événement.

Valeur renvoyée

Type : Microsoft.SharePoint.Workflow.SPWorkflow
Si le flux de travail peut être démarré immédiatement, la méthode retourne une nouvelle instance de flux de travail. S'il ne peut pas être exécuté immédiatement, la méthode retourne une référence Null (Rien dans Visual Basic).

Exceptions

Exception	Condition
ArgumentNullException	L'argument pour le paramètre de l'élément ou l'association est une référence Null (Rien dans Visual Basic).
ArgumentException	L'association de flux de travail passée au paramètre d'association n'est pas compatible avec l'élément de la liste passée au paramètre de l'élément. L'élément peut avoir un contenu erroné tapez ou appartenir à un type de liste incorrect. Ou le type de contenu de l'élément est dérivé du type de contenu de WorkflowTask , mais la propriété IsDeclarative de l'association de flux de travail est false; Seuls les flux de travail déclaratifs peut être démarré sur un élément de tâche. Un ArgumentException est également levée si la propriété Enabled de l'association de flux de travail est false.
UnauthorizedAccessException	L'utilisateur actuel dispose d'autorisations suffisantes pour démarrer le flux de travail.
SPException	L'élément est actuellement verrouillé en raison d'un verrou à court terme ou d'extraction.