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

项目
06/15/2015

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

适用范围： SharePoint Server 2010

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

说明

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

先决条件

Microsoft SharePoint Server 2010 或 Microsoft SharePoint Foundation 2010 位于服务器上。
Microsoft .NET Framework 3.5 和 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 中自动生成的代码。
将实体名称、LobSystemInstance 名称和 LobSystem 名称替换为有效值。
保存该项目。
编译并运行该项目。

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

namespace SDKSamples
{
    class Methods
    {
        //Foreign Key Based AssociationNavigator.
        public static void AssociationNavigatorSample()
        {
            BdcService service = 
                SPFarm.Local.Services.GetValue<BdcService>(String.Empty);
            IMetadataCatalog catalog = 
                service.GetDatabaseBackedMetadataCatalog(
                SPServiceContext.Current);

            // Get entities.
            IEntity customerEntity = catalog.GetEntity(
                "AdventureWorks", "Customer");
            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 customerInstance = 
                customerEntity.FindSpecific(
                new Identity(1), 
                "Read Item", 
                lobSystemInstance, 
                OperationMode.Offline);

            // Get the association.
            IAssociation association = 
                (IAssociation)salesOrderEntity.GetMethodInstance(
                "Customers Sales Orders", 
                MethodInstanceType.AssociationNavigator);

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

            IEntityInstanceEnumerator associatedInstances = null;
            try
            {
                // Navigate the association.
                associatedInstances = 
                    salesOrderEntity.FindAssociated(
                    sourceInstances, 
                    association, 
                    lobSystemInstance, 
                    OperationMode.Offline);

                // List all sales orders for customer 1.
                Debug.WriteLine(
                    "Listing customer's 1 sales orders ID and dates:");
                while (associatedInstances.MoveNext())
                {
                    Debug.WriteLine(
                        String.Format(
                        "Id: {0}, OrderDate: {1}", 
                        associatedInstances.Current["SalesOrderID"], 
                        associatedInstances.Current["OrderDate"]));
                }
            }
            finally
            {
                // Ensure the enumerator is closed.
                if (associatedInstances != null)
                {
                    associatedInstances.Close();
                }
            }
        }
    }
}