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

Artículo
05/13/2015

Crea y se 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 y, opcionalmente, indica si este flujo de trabajo se inicia automática o manualmente.

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, _
    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
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.

isAutoStart
Tipo: System.Boolean

Si el argumento es true, el método intenta iniciar el flujo de trabajo inmediatamente; Si no se puede iniciar inmediatamente, a continuación, se aplaza el inicio y se devuelve un objeto de SPWorkflow que hace referencia el flujo de trabajo no han comenzado. Si el argumento es false, el método intenta iniciar el flujo de trabajo inmediatamente; Si no se puede iniciar inmediatamente, se devuelve el una referencia null (Nothing en Visual Basic) .

Valor devuelto

Tipo: Microsoft.SharePoint.Workflow.SPWorkflow
Una nueva instancia de flujo de trabajo o una referencia null (Nothing en Visual Basic), según el argumento para el parámetro isAutoStart.

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 bien, el tipo de contenido del elemento se deriva de la WorkflowTask contenido de tipo, 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.