在 Business Data Connectivity (BDC) Service 中使用点标记

上次修改时间: 2010年4月19日

适用范围: SharePoint Server 2010

本文内容
示例 1:引用复杂类型的字段
示例 2:访问集合
示例 3:引用具有特殊字符的字段

外部系统返回的数据结构可包含具有多个级别的数据元素的复杂结构。在 Business Data Connectivity (BDC) Service 中,可使用点标记来访问每个级别的数据元素。点标记是数据元素的一种表示形式,它与访问 C# 中的数据元素类似。通过提供数据元素的父数据元素及其名称(如果包含的数据元素是一个结构)或其索引(如果包含的元素是一个集合)来访问每个数据元素。以下是如何使用点标记的一些示例。

示例 1:引用复杂类型的字段

假定 Customer 结构是一个具有以下字段的外部项:

  • CustomerID

  • Name

  • PhoneNumber

  • Address

    • Street

    • City

    • State

    • Zip

Address 字段是一个复杂类型。假定您要显示 Customer 外部项中的以下字段:

  • Name

  • PhoneNumber

  • City

  • State

在此示例中,您可以使用 IEntityInstance 接口中的索引器来获取这些字段,如以下代码所示。

IEntityInstance customerItem = customerEntity.FindSpecific (...);

customerItem["Name"]
customerItem["PhoneNumber"]
customerItem["Address.City"]
customerItem["Address.State"]

示例 2:访问集合

您还可通过使用 BDC 来引用集合中的成员。假定一个具有以下字段的 Customer 结构:

  • CustomerID

  • Name

  • PhoneNumber

  • Addresses(它是 Address 元素的集合)

    • Address

      • Street

      • City

      • State

      • Zip

此示例中的 Customer 结构包含一个 Address 集合。假定该集合中的第一个地址是主地址,并且您希望显示 Customer 外部项中的以下字段:

  • CustomerID

  • Name

  • PhoneNumber

  • PrimaryAddressCity

  • PrimaryAddressState

在此示例中,可在 SpecificFinder 方法实例的返回参数中引用 Customer 结构的 City 和 State 子字段,如以下代码所示。

Customer.Addresses[0].City
Customer.Addresses[0].State

示例 3:引用具有特殊字符的字段

如果名称包含下列特殊字符之一:反斜杠("\")、句点(".")或方括号("["),则必须使用"\"对特殊字符进行转义。

假定一个具有以下字段的 Customer 结构:

  • CustomerID

  • Name

  • PhoneNumber

  • Address

    • Street

    • House\PropertyNo

    • City

    • State

    • Zip

字段"House\PropertyNo"包含以下特殊字符:"\"。假定您要显示 Customer 外部项中的以下字段:

  • CustomerID

  • Name

  • PhoneNumber

  • House\PropertyNo

  • City

  • State

在此示例中,可在 SpecificFinder 方法实例的返回参数中引用 Customer 结构的 House\PropertyNo 子字段,如以下代码所示:

Customer.Address.House\\PropertyNo