代码段：执行外部内容类型的 Associator 和 Disassociator 方法实例

项目
06/15/2015

上次修改时间： 2010年5月6日

适用范围： SharePoint Server 2010

本文内容
说明
先决条件
使用此示例

说明

以下代码示例演示如何使用服务器上的 BDC 运行时对象模型，以编程方式执行外部内容类型的 Associator 和 Disassociator 方法实例。

先决条件

Microsoft SharePoint Server 2010 或 Microsoft SharePoint Foundation 2010 位于服务器上。
Microsoft .NET Framework 3.5 和 Microsoft Visual Studio 位于客户端计算机上。
至少有一个外部内容类型在 BDC 元数据存储区注册。

使用此示例

启动 Visual Studio 并创建 C# 控制台应用程序项目。创建项目时选择".NET Framework 3.5"。
从"视图"菜单中，单击"属性页"以显示项目属性。
在"生成"选项卡中，为"目标平台"选择"任何 CPU"。
关闭项目属性窗口。
在"解决方案资源管理器"中的"引用"下，删除除 System 和 System.Core 之外的所有项目引用。
向项目中添加以下引用：
1. Microsoft.BusinessData
2. Microsoft.SharePoint
3. Microsoft.SharePoint.BusinessData
用此过程结尾处列出的代码替换 Program.cs 中自动生成的代码。
将实体名称、LobSystem 名称和 LobSystemInstance 名称的值替换为有效的值。
保存该项目。
编译并运行该项目。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Microsoft.BusinessData.Runtime;
using Microsoft.BusinessData.MetadataModel;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Administration;
using Microsoft.SharePoint.BusinessData.SharedService;

namespace SDKSamples
{
    class Associate
    {
        // FKLessAssociateDisAssociate.
        public static void AssociateSalesOrderWithSalesReasonSample()
        {
            BdcService service = 
                SPFarm.Local.Services.GetValue<BdcService>(String.Empty);
            IMetadataCatalog catalog = 
                service.GetDatabaseBackedMetadataCatalog(
                SPServiceContext.Current);

            // Get entities.
            IEntity salesReasonEntity = catalog.GetEntity(
                "AdventureWorks", "SalesReason");
            IEntity salesOrderEntity = catalog.GetEntity(
                "AdventureWorks", "SalesOrder");

            // Get LOB System instance.
            ILobSystemInstance lobSystemInstance = 
                salesOrderEntity.GetLobSystem().GetLobSystemInstances()
                ["AdventureWorks"];

            // Get the source entity instance with ID 1 to use to navigate the association.
            IEntityInstance salesReasonInstance = 
                salesReasonEntity.FindSpecific(
                new Identity(1), 
                "Read Item", 
                lobSystemInstance, 
                OperationMode.Offline);
            IEntityInstance salesOrderInstance = 
                salesOrderEntity.FindSpecific(
                new Identity(44444), 
                "Read Item", 
                lobSystemInstance, 
                OperationMode.Offline);

            // Create a collection with the source instance.
            EntityInstanceCollection sourceInstances = 
                new EntityInstanceCollection(1);
            sourceInstances.Add(salesReasonInstance);

            // Get the association.
            IAssociation associator = 
                (IAssociation)salesOrderEntity.GetMethodInstance(
                "Sales Order by Reason Associator", 
                MethodInstanceType.Associator);

            // Associate.
            salesOrderEntity.Associate(
                sourceInstances, 
                salesOrderInstance, 
                associator, 
                lobSystemInstance);

            // Get the disassociator.
            IAssociation disassociator = 
                (IAssociation)salesOrderEntity.GetMethodInstance(
                "Sales Order by Reason Disassociator", 
                MethodInstanceType.Disassociator);

            // Disassociate.
            salesOrderEntity.Disassociate(
                sourceInstances, 
                salesOrderInstance, 
                disassociator, 
                lobSystemInstance);            
        }

    }
}