SPContentType.WorkflowAssociations 属性
获取一个代表此内容类型的工作流关联的SPWorkflowAssociationCollection对象。
命名空间： Microsoft.SharePoint
程序集： Microsoft.SharePoint（位于 Microsoft.SharePoint.dll 中）
语法
声明
Public ReadOnly Property WorkflowAssociations As SPWorkflowAssociationCollection
Get
用法
Dim instance As SPContentType
Dim value As SPWorkflowAssociationCollection
value = instance.WorkflowAssociations
public SPWorkflowAssociationCollection WorkflowAssociations { get; }
属性值
类型：Microsoft.SharePoint.Workflow.SPWorkflowAssociationCollection
与内容类型关联的工作流的集合。
备注
WorkflowAssociations属性返回一个SPWorkflowAssociationCollection的工作流关联的内容类型的集合。您可以使用作为索引器Id属性的值或将工作流关联的名称传递给GetAssociationByName方法从集合中检索关联。
集合中的每个工作流关联的Name属性中必须唯一值。添加新的工作流关联时，您应测试是否符合该名称的工作流关联已存在集合中。如果您的工作流关联已集合的成员，并且您想要更新现有的关联，而是调用Update方法。
可以通过调用GetAssociationByName方法来测试的内容类型的集合中的工作流关联存在。如果该方法的返回值不是空引用（无 在 Visual Basic 中），然后关联正在集合。下面的示例演示了此技术。
If contentType.WorkflowAssociations.GetAssociationByName(workflowAssociation.Name, site.Locale) Is Nothing Then
contentType.WorkflowAssociations.Add(workflowAssociation)
Else
contentType.WorkflowAssociations.Update(workflowAssociation)
End If
if (contentType.WorkflowAssociations.GetAssociationByName(workflowAssociation.Name, site.Locale) == null)
{
contentType.WorkflowAssociations.Add(workflowAssociation);
}
else
{
contentType.WorkflowAssociations.Update(workflowAssociation);
}
示例
下面的示例是一个控制台应用程序创建工作流关联，将其添加到的工作流关联的网站内容类型的集合并然后传播内容类型的子级的变化。
Imports System
Imports Microsoft.SharePoint
Imports Microsoft.SharePoint.Workflow
Module ConsoleApp
Sub Main()
Console.WriteLine()
Dim siteCollection As SPSite = New SPSite("https://localhost")
Dim site As SPWeb = siteCollection.OpenWeb()
Dim siteContentType As SPContentType = site.ContentTypes("Test Document")
Dim taskListTitle As String = "Tasks"
Dim historyListTitle As String = "Workflow History"
Dim workflowName As String = "Red-Yellow-Green"
' Get a template.
Dim workflowTemplate As SPWorkflowTemplate = Nothing
For Each template As SPWorkflowTemplate In site.WorkflowTemplates
workflowTemplate = template
' We'll take a template everyone has
If workflowTemplate.Name = "Three-state" Then
Exit For
End If
Next template
' Create an association.
Dim workflowAssociation As SPWorkflowAssociation = _
SPWorkflowAssociation.CreateSiteContentTypeAssociation(workflowTemplate, _
workflowName, _
taskListTitle, _
historyListTitle)
' Add the association to the content type or update it if it already exists.
Console.Write("Workflow association {0} has been ", workflowAssociation.Name)
If siteContentType.WorkflowAssociations.GetAssociationByName(workflowAssociation.Name, site.Locale) Is Nothing Then
siteContentType.WorkflowAssociations.Add(workflowAssociation)
Console.WriteLine("added.")
Else
siteContentType.WorkflowAssociations.Update(workflowAssociation)
Console.WriteLine("updated.")
End If
' Propagate to children of this content type.
siteContentType.UpdateWorkflowAssociationsOnChildren(False, True, True, False)
' Clean up.
site.Dispose()
siteCollection.Dispose()
Console.WriteLine()
Console.Write("Press ENTER to continue...")
Console.ReadLine()
End Sub
End Module
using System;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Workflow;
namespace Test
{
class ConsoleApp
{
static void Main(string[] args)
{
Console.WriteLine();
SPSite siteCollection = new SPSite("https://localhost");
SPWeb site = siteCollection.OpenWeb();
SPContentType siteContentType = site.ContentTypes["Test Document"];
string taskListTitle = "Tasks";
string historyListTitle = "Workflow History";
string workflowName = "Red-Yellow-Green";
// Get a template.
SPWorkflowTemplate workflowTemplate = null;
foreach (SPWorkflowTemplate template in site.WorkflowTemplates)
{
workflowTemplate = template;
// We'll take a template everyone has.
if (workflowTemplate.Name == "Three-state") break;
}
// Create an association.
SPWorkflowAssociation workflowAssociation =
SPWorkflowAssociation.CreateSiteContentTypeAssociation(workflowTemplate,
workflowName,
taskListTitle,
historyListTitle);
// Add the association to the content type or update it if it already exists.
Console.Write("Workflow association {0} has been ", workflowAssociation.Name);
if (siteContentType.WorkflowAssociations.GetAssociationByName(workflowAssociation.Name, site.Locale) == null)
{
siteContentType.WorkflowAssociations.Add(workflowAssociation);
Console.WriteLine("added.");
}
else
{
siteContentType.WorkflowAssociations.Update(workflowAssociation);
Console.WriteLine("updated.");
}
// Propagate to children of this content type.
siteContentType.UpdateWorkflowAssociationsOnChildren(false, // Do not generate full change list
true, // Push down to derived content types
true, // Push down to list content types
false); // Do not throw exception if sealed or readonly
site.Dispose();
siteCollection.Dispose();
Console.WriteLine();
Console.Write("Press ENTER to continue...");
Console.ReadLine();
}
}
}
下面的示例是一个控制台应用程序删除了上面的示例创建工作流关联。
Imports System
Imports Microsoft.SharePoint
Imports Microsoft.SharePoint.Workflow
Module ConsoleApp
Sub Main()
Dim site As SPSite = New SPSite("https://localhost")
Try
Dim web As SPWeb = site.OpenWeb()
Try
Dim ctName As String = "Test Document"
Dim wfName As String = "Red-Yellow-Green"
Dim contentType As SPContentType = web.ContentTypes(ctName)
If Not contentType Is Nothing Then
Dim wfAssociation As SPWorkflowAssociation = _
contentType.WorkflowAssociations.GetAssociationByName(wfName, web.Locale)
If Not wfAssociation Is Nothing Then
' Remove the workflow association.
contentType.WorkflowAssociations.Remove(wfAssociation)
Console.WriteLine("The association with {0} workflow has been removed.", wfAssociation.Name)
Else
Console.WriteLine("An association with {0} workflow was not found.", wfName)
End If
Else
Console.WriteLine("Content type {0} does not exist.", ctName)
End If
Finally
web.Dispose()
End Try
Finally
site.Dispose()
End Try
Console.Write(vbCrLf + "Press ENTER to continue...")
Console.ReadLine()
End Sub
End Module
using System;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Workflow;
namespace Test
{
class ConsoleApp
{
static void Main(string[] args)
{
using (SPSite site = new SPSite("https://localhost"))
{
using (SPWeb web = site.OpenWeb())
{
string ctName = "Test Document";
string wfName = "Red-Yellow-Green";
SPContentType contentType = web.ContentTypes[ctName];
if (null != contentType)
{
SPWorkflowAssociation wfAssociation =
contentType.WorkflowAssociations.GetAssociationByName(wfName, web.Locale);
if (null != wfAssociation)
{
// Remove the workflow association.
contentType.WorkflowAssociations.Remove(wfAssociation);
Console.WriteLine("The association with {0} workflow has been removed.", wfAssociation.Name);
}
else
{
Console.WriteLine("An association with {0} workflow was not found.", wfName);
}
}
else
{
Console.WriteLine("Content type {0} does not exist.", ctName);
}
}
}
Console.Write("\nPress ENTER to continue...");
Console.ReadLine();
}
}
}