MethodInstances 中的 MethodInstance 元素（BDCMetadata 架构）

适用于：SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

指定 MethodInstance。

命名空间： http://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>

元素和属性

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

Attributes

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

子元素

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

父元素

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