你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

SearchIndexClient.CreateOrUpdateIndexAsync 方法

定义

命名空间:

Azure.Search.Documents.Indexes

程序集:

Azure.Search.Documents.dll

包:

Azure.Search.Documents v11.5.1

Source:

SearchIndexClient.cs

创建新的搜索索引或更新现有索引。

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Search.Documents.Indexes.Models.SearchIndex>> CreateOrUpdateIndexAsync (Azure.Search.Documents.Indexes.Models.SearchIndex index, bool allowIndexDowntime = false, bool onlyIfUnchanged = false, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateOrUpdateIndexAsync : Azure.Search.Documents.Indexes.Models.SearchIndex * bool * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Search.Documents.Indexes.Models.SearchIndex>>
override this.CreateOrUpdateIndexAsync : Azure.Search.Documents.Indexes.Models.SearchIndex * bool * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Search.Documents.Indexes.Models.SearchIndex>>

Public Overridable Function CreateOrUpdateIndexAsync (index As SearchIndex, Optional allowIndexDowntime As Boolean = false, Optional onlyIfUnchanged As Boolean = false, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of SearchIndex))

参数

index

SearchIndex

必需。 SearchIndex要创建或更新的 。

allowIndexDowntime

Boolean

可选值，指示是否允许分析器、令牌化器、令牌筛选器或字符筛选器通过暂时使索引脱机几秒钟来添加到索引中。 默认值为 false。 这暂时导致索引编制和查询失败。 索引的性能和写入可用性可在更新索引后的几分钟内处于受损状态，对于非常大的索引，持续时间更长。

onlyIfUnchanged

Boolean

如果 与当前服务版本不匹配，则ETag为 True，则引发 RequestFailedException ;否则，将覆盖当前服务版本。

cancellationToken

CancellationToken

可选 CancellationToken ，用于传播应取消操作的通知。

返回

Task<Response<SearchIndex>>

Response<T>包含SearchIndex已创建或更新的 的服务器的 。 这可能与传入的内容略有不同，因为服务可能会返回设置为其默认值的字段，具体取决于字段类型和其他属性。

例外

ArgumentNullException

当 index 为 null 时引发。

RequestFailedException

当搜索服务返回故障时引发。