(SPListItem, SPWorkflowAssociation, String) del método SPWorkflowManager.StartWorkflow

Artículo
05/13/2015

Crea e inicia una nueva instancia de flujo de trabajo en un elemento de lista especificado, basado en una asociación de flujo de trabajo determinado, con parámetros de evento especificados.

Espacio de nombres: Microsoft.SharePoint.Workflow
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)

Sintaxis

'Declaración
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
Tipo: Microsoft.SharePoint.SPListItem

El elemento de lista en la que se va a iniciar la instancia de flujo de trabajo.

association
Tipo: Microsoft.SharePoint.Workflow.SPWorkflowAssociation

La asociación de flujo de trabajo en el que desea basar la nueva instancia de flujo de trabajo.

eventData
Tipo: System.String

Una cadena que contiene los parámetros de evento.

Valor devuelto

Tipo: Microsoft.SharePoint.Workflow.SPWorkflow
Si el flujo de trabajo se puede iniciar inmediatamente, el método devuelve una nueva instancia de flujo de trabajo. Si no se puede iniciar inmediatamente, el método devuelve una referencia null (Nothing en Visual Basic).

Excepciones

Excepción	Condición
ArgumentNullException	El argumento para el parámetro del elemento o la asociación es una referencia null (Nothing en Visual Basic).
ArgumentException	La asociación de flujo de trabajo pasada al parámetro de asociación no es compatible con el elemento de lista que se pasa al parámetro de elemento. El elemento podría tener el contenido equivocado escriba o pertenecen a un tipo de lista incorrecto. O el tipo de contenido del elemento se deriva del tipo de contenido de WorkflowTask , pero la propiedad IsDeclarative de la asociación de flujo de trabajo es false; flujos de trabajo declarativos pueden iniciarse en un elemento de tarea. Un ArgumentException también se produce si la propiedad Enabled de la asociación flujo de trabajo es false.
UnauthorizedAccessException	El usuario actual tiene permisos suficientes para iniciar el flujo de trabajo.
SPException	El elemento está bloqueado debido a un bloqueo a corto plazo o desprotección.