FilterDescriptors 中的 FilterDescriptor 元素（BDCMetadata 架构）

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

指定方法的筛选器描述符。

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

架构：BDCMetadata

<FilterDescriptor Type = "String" FilterField = "String" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </FilterDescriptor>

元素和属性

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

Attributes

属性	说明
**类型**	必填。 筛选器描述符的类型。 下表列出了该属性可能的值。 值 说明 限制 在查询外部系统时使用，其值可以解释为调用它所属的方法时返回的外部项数限制 (**EntityInstances**) 。 PageNumber 通配符 查询外部系统时使用。 它的值表示常规字符和通配符模式，该模式与一组 EntityInstances 的特定字段的值进行匹配。 外部系统仅返回其字段值与指定模式匹配的那些 EntityInstances。 UserContext 查询外部系统时使用。 它的值可以由任何客户端应用程序自动设置为调用外部系统的用户的标识。 然后，外部系统可以使用该值进行授权并筛选返回的结果。 UserCulture Username Password LastId SsoTicket UserProfile 查询外部系统时使用。 它的值可以通过检查当前用户的配置文件获得。 外部系统可以使用它的值筛选返回的结果。 Comparison 查询外部系统时使用。 外部系统可以将 **ComparisonFilter** 值与一组 **EntityInstances** 的特定字段的值进行比较，并且只能返回字段值通过比较测试的那些 **EntityInstances**。 Timestamp Input 在调用外部系统中的操作时使用。 外部系统可以使用 InputFilter 的值作为操作的其他参数。 输出 在调用外部系统中的操作时使用。 无法由 ReturnTypeDescriptor 捕获的操作的其他结果可以作为 InputOutputFilter 的值进行检索。 InputOutput 在调用外部系统中的操作时使用。 外部系统可以使用 “InputOutputFilter” 的值作为操作的其他参数，而无法由 ReturnTypeDescriptor 捕获的操作的其他结果可以作为 InputOutputFilter 的值进行检索。 批处理 BatchingTermination ActivityId 在外部系统上调用操作时，使用 ActivityId。 它的值设置为表示当前操作上下文的 GUID。 如果没有提供此类值，则此筛选器将生成随机 GUID。 在 SharePoint Foundation 2010 上，此筛选器使用“CorrelationID”。
**FilterField**	可选。 属性类型：**String**
**名字**	必填。 筛选器描述符的名称。 属性类型：**String**
**DefaultDisplayName**	可选。 筛选器描述符的默认显示名称。 属性类型：**String**
**IsCached**	可选。 指定是否经常使用此筛选器描述符。 如果设置为 “true”，则业务数据连接 (BDC) 服务将此筛选器描述符缓存在内存中。 默认值：**true** 属性类型：**布尔值**

子元素

元素	说明
MetadataObject 中的 LocalizedDisplayNames 元素（BDCMetadata 架构）	此筛选器描述符的本地化显示名称。
MetadataObject 中的 Properties 元素（BDCMetadata 架构）	此筛选器描述符的属性。

父元素

元素	说明
Method 中的 FilterDescriptors 元素（BDCMetadata 架构）	方法的筛选器描述符列表。