SPWorkflowAssociation.CreateWebAssociation Method

Creates a workflow association that can then be added to an SPWeb object.

Namespace:  Microsoft.SharePoint.Workflow
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Available in Sandboxed Solutions: Yes
Available in SharePoint Online

Syntax

'Declaration
Public Shared Function CreateWebAssociation ( _
    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.CreateWebAssociation(baseTemplate, _
    name, taskList, historyList)
public static SPWorkflowAssociation CreateWebAssociation(
    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
A workflow association that can be added to an SPWeb object.

Exceptions

Exception Condition
ArgumentNullException

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

ArgumentException

The name parameter consists completely of white-space.

Remarks

You can add the workflow association that is returned by this method by calling the AddWorkflowAssociation(SPWorkflowAssociation) method of an SPWeb object.

See Also

Reference

SPWorkflowAssociation Class

SPWorkflowAssociation Members

Microsoft.SharePoint.Workflow Namespace