Azure AI Search V11升级后SearchOptions字段高亮数量设置问题

• 全局统一设置高亮数量
  在SearchOptions中通过HighlightCount属性全局指定所有高亮字段的返回数量，示例代码：

  var searchOptions = new SearchOptions
  {
      HighlightFields = { "Id", "Name" },
      HighlightCount = 10 // 所有高亮字段都返回10个高亮片段
  };
  

• 针对单个字段单独配置
  使用HighlightOptions类为特定字段单独设置高亮数量，不影响其他字段的全局默认值，示例代码：

  var searchOptions = new SearchOptions
  {
      HighlightFields = { "Id", "Name" }
  };
  // 仅为Name字段设置10个高亮片段
  searchOptions.HighlightOptions.Add("Name", new HighlightOptions { Count = 10 });
  

• 关键说明
  V11版本的SDK不再支持旧版REST API中字段名-数量的写法，必须通过HighlightCount（全局配置）或HighlightOptions（单字段配置）来指定高亮片段数量，这是SDK封装后的标准用法。

内容的提问来源于stack exchange，提问作者chetan s