概述

搜索上下文功能从2013年第二季度开始添加，以便为搜索操作提供背景。搜索上下文表示为一个简单的下拉菜单，提供选择上下文项的选项。该特性提高了在大型数据集中搜索时的性能和可用性。

SearchBox的搜索上下文就像一个标准的下拉列表控件，只有一个选择。它的项目是可访问的服务器和客户端。

        < / telerik: RadSearchBox >

支持的功能

RadSearchBox的搜索上下文支持的功能摘要

数据绑定-将SearchContext绑定到数据源
声明性物品SeachContextItems可以在标记中定义，也可以从代码背后动态添加。
服务器端-使用DataSourceID/DataSource属性设置数据源的服务器API。
客户端-通过Web服务和集成RadODataDataSource控件进行填充的客户端A万博体育手机版网址PI。
默认“All”项-搜索上下文显示一个项目，当选择该项目时，将不会为搜索操作提供上下文。这一项可以省略，如果ShowDefaultItem属性被设置为False(默认为True)。
加载消息-当默认项不显示时，SearchContext从web服务中填充或绑定到RadODataDataSource控件，当项被加载和初始化时，在搜索上下文的输入中显示一条消息。一旦加载，消息将被删除，并选择列表中的第一项。
本地化-默认项目的文本以及加载消息都可以通过Localization-DefaultItemText而且Localization-LoadingItemsMessage属性。
键盘支持-搜索上下文有一个功能齐全的键盘支持，这是可用的，一旦控制是集中。为了能够集中搜索上下文TabIndex属性。

将搜索上下文绑定到特定数据源时，需要使用以下属性。

数据源-设置为数据源的实例。在运行时绑定SearchContext时，这是必须的。
DataSourceID-设置为数据源控件的ID (SqlDataSource, ObjectDataSource等)。当以声明方式绑定SearchContext时，这是强制的。
DataTextField-从绑定到SearchContextItem的数据源中设置字段名文本财产。
DataKeyField-从绑定到SearchContextItem的数据源中设置字段名关键财产。
DataModelID—绑定SearchContext到RadODataDataSource控件时设置ModelID。

一旦配置了数据绑定，您将能够通过SearchContext Item对象访问这些值。有关列表属性和方法，请查看SearchContextItem对象篇文章。

服务器端：
- ItemDataBound-服务器端事件触发每个SearchContextItem创建作为绑定到数据源的结果。
客户端：
- ClientItemDataBound-客户端事件触发每个SearchContextItem创建作为绑定到RadODataDataSource控件的结果。
- ClientItemSelected-选择SearchContext项时触发的客户端事件。

搜索上下文和RadSearchBox之间的集成可以通过两种方式实现。当SearchBox绑定到数据源组件或RadODataDataSource控件时，DataContextKeyField的属性SearchBox应设置为执行搜索操作时将用作上下文的数据字段。

当从web服务或服务器提供搜索结果时DataSourceSelect当事件被处理时，所选上下文项可以通过服务器输入上下文参数的SelectedContextItem属性或事件的事件参数获得。