SPWorkflowAssociation.CreateListAssociation method

Creates a workflow association that can then be added to a list.

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

Syntax

'Declaration
Public Shared Function CreateListAssociation ( _
    baseTemplate As SPWorkflowTemplate, _
    name As String, _
    taskList As SPList, _
    historyList As SPList _
) As SPWorkflowAssociation
'Usage
Dim baseTemplate As SPWorkflowTemplate
Dim name As String
Dim taskList As SPList
Dim historyList As SPList
Dim returnValue As SPWorkflowAssociation

returnValue = SPWorkflowAssociation.CreateListAssociation(baseTemplate, _
    name, taskList, historyList)
public static SPWorkflowAssociation CreateListAssociation(
    SPWorkflowTemplate baseTemplate,
    string name,
    SPList taskList,
    SPList historyList
)

Parameters

  • name
    Type: System.String

    The name to give this workflow association.

Return value

Type: Microsoft.SharePoint.Workflow.SPWorkflowAssociation
An SPWorkflowAssociation that represents the workflow association.

Exceptions

Exception Condition
ArgumentNullException

The argument passed to the baseTemplate parameter is a null reference (Nothing in Visual Basic); or the argument to the name parameter is a null reference (Nothing in Visual Basic); or the template requires a task list (the default) and the argument to the taskList parameter is a null reference (Nothing in Visual Basic); or the template requires a history list (the default) and the argument to the historyList parameter is a null reference (Nothing in Visual Basic).

ArgumentException

The string passed to the name parameter contains only spaces or tabs.

Remarks

To associate a workflow template with a list or document library, use the AddWorkflowAssociation method of the SPList object. This method takes an SPWorkflowAssociation object and adds it to the specified list.

See also

Reference

SPWorkflowAssociation class

SPWorkflowAssociation members

Microsoft.SharePoint.Workflow namespace

Other resources

Workflows in Windows SharePoint Services

Workflow Development for Windows SharePoint Services

Workflow Object Model in Windows SharePoint Services Overview