添加 Finder 方法

若要使业务数据连接 (BDC) 服务能够在 Web 部件或列表中显示实体列表,必须创建 Finder 方法。 Finder 方法是一种特殊的方法,它可以返回实体实例的集合。 有关详细信息,请参阅设计业务数据连接模型

创建 Finder 方法

  1. 在“BDC 设计器”上,选择一个实体。

    有关详细信息,请参阅如何:向模型添加实体

  2. 在菜单栏上,选择“视图”>“其他窗口”>“BDC 方法详细信息”。

    “BDC 方法详细信息”窗口将打开。 有关“BDC 方法详细信息”窗口的详细信息,请参阅 BDC 模型设计工具概述

  3. 在“添加方法”列表中,选择“创建 Finder 方法”。

    Visual Studio 添加了一个方法、一个返回参数和一个类型描述符。

  4. 将类型描述符配置为一个实体集合类型描述符。 若要详细了解如何创建实体集合类型描述符,请参阅如何:定义参数的类型描述符

    注意

    如果你已经向实体添加了特定的 Finder 方法,则无需执行此步骤。 Visual Studio 将使用你在特定的 Finder 方法中定义的类型描述符。

  5. 在“解决方案资源管理器”中,打开为实体生成的服务代码文件的快捷菜单,然后选择“查看代码”。 有关服务代码文件的详细信息,请参阅创建业务数据连接模型

  6. 向 Finder 方法添加代码。 此代码执行以下任务:

    • 从数据源中检索数据。

    • 将实体列表返回给 BDC 服务。

      以下示例使用 SQL Server AdventureWorks 示例数据库中的数据返回 Contact 实体的集合。

    注意

    ServerName 字段的值替换为你的服务器名称。

    public static IEnumerable<Contact> ReadList()
    {
        const string ServerName = "MySQLServerName";
        AdventureWorksDataContext dataContext = new AdventureWorksDataContext
              ("Data Source=" + ServerName + ";" +
               "Initial Catalog=AdventureWorks;Integrated Security=True");
    
        IEnumerable<Contact> Contacts =
            from contacts in dataContext.Contacts.Take(20)
            select contacts;
        return Contacts;
    
    }