MethodInstances 中的 MethodInstance 元素（BDCMetadata 架构）

上次修改时间： 2015年3月9日

适用范围： SharePoint Server 2010

指定 MethodInstance。

**命名空间：**https://schemas.microsoft.com/windows/2007/BusinessDataCatalog

**架构：**BDCMetadata

在 BDC 模型中，以下两种情况会导致在运行时出现 InvalidOperationException：

• 两个 SpecificFinder 方法实例，它们返回相同的字段集。

• 两个 SpecificFinder 方法实例，它们具有相同数量的字段并与另一个方法实例（如 Finder）共享相同数量的字段。

<MethodInstance Type = "String" Default = "Boolean" ReturnParameterName = "String" ReturnTypeDescriptorName = "String" ReturnTypeDescriptorLevel = "Integer" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </MethodInstance>

属性和元素

以下各部分介绍了属性、子元素和父元素。

属性

属性	说明
类型	必需。 指定 MethodInstance 的类型。 下表列出了该属性可能的值。 值 说明 Finder 一种 MethodInstance 类型，可调用它以返回包含特定 Entity 的零个或多个 EntityInstances 的集合。Finder 输入由包含 Finder 的 Method 中包含的 FilterDescriptors 定义。 SpecificFinder 一种 MethodInstance 类型，可调用它以返回特定 Entity（给定其 EntityInstanceId）的特定 EntityInstance。SpecificFinder 输入由与 Entity 关联的 Identifiers 定义和排序。 GenericInvoker 一种 MethodInstance 类型，可调用它以便在外部系统中执行特定任务。GenericInvoker 输入和输出因 Method 而异。 IdEnumerator 一种 MethodInstance 类型，可调用它以返回表示特定 Entity 的 EntityInstances 的标识的 Field 值。IdEnumerator 输入是由 FilterDescriptors 定义的，后者包含在包含用于获取 ID 列表的 IdEnumerator 的方法中，这些 ID 是可搜索的每个实体的唯一键。此方法实例在 Microsoft SharePoint Server 2010 中启用了外部数据搜索。 ChangedIdEnumerator 一种 MethodInstance 类型，可调用它以检索经指定时间后在外部系统中修改过的 EntityInstances 的 EntityInstanceIds。 DeletedIdEnumerator 一种 MethodInstance 类型，可调用它以检索经指定时间后从外部系统中删除的 EntityInstances 的 EntityInstanceIds。 Scalar 一个 MethodInstance，它返回可在外部系统中调用的单一值。例如，可使用标量方法实例从外部系统获取到目前为止实现的总销售额。Entities 具有零个或多个标量方法实例。 AccessChecker 一种 MethodInstance 类型，可调用它以检索调用安全主体拥有的针对每个 EntityInstances 集合（由指定的 EntityInstanceIds 标识）的权限。 Creator 一种 MethodInstance 类型，可调用它以创建 EntityInstance。创建 EntityInstance 所需的字段集合称为"生成器视图"。 Deleter 一种 MethodInstance 类型，可调用它以删除具有指定的 EntityInstanceId 的 EntityInstance。 Updater 一种 MethodInstance 类型，可调用它以更新由指定的 EntityInstanceId 标识的 EntityInstance。更新 EntityInstance 所需的字段集合称为"更新程序视图"。更改其值前应先传递这些值的字段的集合称为"预更新程序视图"。 StreamAccessor 一种 MethodInstance 类型，可调用它以检索采用字节数据流形式的 EntityInstance 的字段。 BinarySecurityDescriptorAccessor 一种 MethodInstance 类型，可调用它以从外部系统检索字节序列。特定于系统的字节序列描述一组安全主体以及每个安全主体拥有的针对 EntityInstance（由指定的 EntityInstanceId 标识）的关联权限。 BulkSpecificFinder 一种 MethodInstance 类型，可调用它以返回 Entity 的一组特定的 EntityInstances（给定一组相应的 EntityInstanceIds）。 BulkIdEnumerator 一种 MethodInstance 类型，可调用它以检索有关对应于给定标识的外部项的最少信息。此方法实例可用于优化缓存数据的同步。此方法应仅返回对应于给定 Identities 的外部项的标识和版本信息，调用的应用程序可将这些标识与本地版本进行比较以确定是否有任何项发生了更改，如果有，则请求更改的外部项以更新缓存数据。
Default	可选。 指定 MethodInstance 是否为所有 MethodInstances（它们在包含外部内容类型 (Entity) 中共享其类型）中的默认值。 默认值：false 属性类型：Boolean
ReturnParameterName	可选。 Parameter（它包含 MethodInstance 的 ReturnTypeDescriptor）的名称。Parameter 的 Direction 属性必须是具有 Out、InOut 或 Return 值的 ParameterDirection 属性。 必须为所有类型的 MethodInstances（GenericInvoker、Creator、Deleter 和 Updater 除外）指定此属性。 属性类型：String
ReturnTypeDescriptorLevel	可选。 此属性已被弃用。请改用 ReturnTypeDescriptorPath。 属性类型：Integer
ReturnTypeDescriptorPath	可选。 Association 的 TypeDescriptor 的虚线路径。 属性类型：String
名称	必需。 指定 MethodInstance 的名称。 属性类型：String
DefaultDisplayName	可选。 指定 MethodInstance 的默认显示名称。 属性类型：String
IsCached	可选。 指定是否频繁使用 MethodInstance。 默认值：true 属性类型：Boolean

子元素

元素	说明
MetadataObject 中的 LocalizedDisplayNames 元素（BDCMetadata 架构）	MethodInstance 的本地化显示名称。
MetadataObject 中的 Properties 元素（BDCMetadata 架构）	MethodInstance 的属性。
AccessControlList 元素（BDCMetadata 架构）	MethodInstance 访问控制列表 (ACL)。

父元素

元素	说明
Method 中的 MethodInstances 元素（BDCMetadata 架构）	包含此 MethodInstance 的 MethodInstances 元素。