SPWorkflowManager.StartWorkflow method (SPListItem, SPWorkflowAssociation, String, Boolean)

Artigo
05/12/2015

Cria e inicia uma nova instância de fluxo de trabalho em um item de lista especificada, com base em uma associação de fluxo de trabalho especificado, com parâmetros de evento especificado e, opcionalmente, indica se o fluxo de trabalho está iniciando automaticamente ou manualmente.

Namespace: Microsoft.SharePoint.Workflow
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaração
Public Function StartWorkflow ( _
    item As SPListItem, _
    association As SPWorkflowAssociation, _
    eventData As String, _
    isAutoStart As Boolean _
) As SPWorkflow
'Uso
Dim instance As SPWorkflowManager
Dim item As SPListItem
Dim association As SPWorkflowAssociation
Dim eventData As String
Dim isAutoStart As Boolean
Dim returnValue As SPWorkflow

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

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

Parâmetros

item
Type: Microsoft.SharePoint.SPListItem

O item da lista na qual deseja iniciar a instância do fluxo de trabalho.

association
Type: Microsoft.SharePoint.Workflow.SPWorkflowAssociation

A associação de fluxo de trabalho no qual basear a nova instância de fluxo de trabalho.

eventData
Type: System.String

Uma seqüência de caracteres que contém os parâmetros de evento.

isAutoStart
Type: System.Boolean

Se o argumento for true, então o método tenta iniciar o fluxo de trabalho imediatamente; Se não puder ser iniciado imediatamente, o início é adiado e é retornado um objeto de SPWorkflow referenciando o fluxo de trabalho não iniciado. Se o argumento for false, o método tenta iniciar o fluxo de trabalho imediatamente; Se não puder ser iniciado imediatamente, a null reference (Nothing in Visual Basic) é retornado.

Valor retornado

Type: Microsoft.SharePoint.Workflow.SPWorkflow
Uma nova instância de fluxo de trabalho ou a null reference (Nothing in Visual Basic), dependendo do argumento para o parâmetro isAutoStart.

Exceptions

Exception	Condition
ArgumentNullException	O argumento para o parâmetro do item ou o parâmetro de associação é a null reference (Nothing in Visual Basic).
ArgumentException	A associação de fluxo de trabalho passada para o parâmetro de associação não é compatível com o item passado para o parâmetro de item da lista. O item pode ter conteúdo incorreto digite ou pertencem ao tipo errado de lista. Ou, o tipo de conteúdo do item é derivado de WorkflowTask conteúdo de tipo, mas a propriedade IsDeclarative da associação de fluxo de trabalho é false; apenas fluxos de trabalho podem ser iniciados em um item de tarefa. Um ArgumentException também é lançada se Enabled propriedade a associação de fluxo de trabalho for false.
UnauthorizedAccessException	O usuário atual tem permissões insuficientes para iniciar o fluxo de trabalho.
SPException	O item está bloqueado no momento devido a um bloqueio de curta duração ou check-out.