SPWorkflowManager.StartWorkflow method (SPListItem, SPWorkflowAssociation, String)

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.

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 _
) As SPWorkflow
'Uso
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
)

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.

Valor retornado

Type: Microsoft.SharePoint.Workflow.SPWorkflow
Se o fluxo de trabalho pode ser iniciado imediatamente, o método retorna uma nova instância de fluxo de trabalho. Se não puder ser iniciado imediatamente, o método retorna a null reference (Nothing in Visual Basic).

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 do tipo de conteúdo WorkflowTask , 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.