你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
SearchClient.Search<T>(String, SearchOptions, CancellationToken) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
在搜索索引中搜索文档。 搜索文档
public virtual Azure.Response<Azure.Search.Documents.Models.SearchResults<T>> Search<T> (string searchText, Azure.Search.Documents.SearchOptions options = default, System.Threading.CancellationToken cancellationToken = default);
abstract member Search : string * Azure.Search.Documents.SearchOptions * System.Threading.CancellationToken -> Azure.Response<Azure.Search.Documents.Models.SearchResults<'T>>
override this.Search : string * Azure.Search.Documents.SearchOptions * System.Threading.CancellationToken -> Azure.Response<Azure.Search.Documents.Models.SearchResults<'T>>
Public Overridable Function Search(Of T) (searchText As String, Optional options As SearchOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Response(Of SearchResults(Of T))
类型参数
- T
映射到索引架构的 .NET 类型。 此类型的实例可以作为文档从索引中检索。
参数
- searchText
- String
全文搜索查询表达式;使用“*”或省略此参数以匹配所有文档。 有关搜索查询语法的详细信息,请参阅 Azure 认知搜索 中的简单查询语法。
- options
- SearchOptions
允许指定筛选、排序、分面、分页和其他搜索查询行为的选项。
- cancellationToken
- CancellationToken
可选 CancellationToken ,用于传播应取消操作的通知。
返回
包含与查询匹配的文档的响应。
例外
搜索服务返回失败时引发。
注解
Search 和 SearchAsync 方法支持通过类型参数 T 将搜索字段类型映射到 .NET 类型。可以提供自己的类型 T
或使用动态 SearchDocument。 有关类型映射的更多详细信息,请参阅 GetDocumentAsync<T>(String, GetDocumentOptions, CancellationToken) 。
Azure 认知搜索可能无法将所有结果包含在单个响应中,在这种情况下GetResults(),在枚举结果时会自动继续发出其他请求。 还可以使用 AsPages(String, Nullable<Int32>) 方法一次一页地处理结果。