快速入門：使用適用於 C# 的 Bing 拼字檢查 SDK 進行檢查拼字

發行項
12/16/2019

警告

在 2020 年 10 月 30 日，Bing 搜尋 API 已從 Azure AI 服務移至 Bing 搜尋服務。本文件僅供參考之用。如需更新的文件，請參閱 Bing 搜尋 API 文件。如需針對 Bing 搜尋建立新 Azure 資源的指示，請參閱透過 Azure Marketplace 建立 Bing 搜尋資源。

透過本快速入門使用適用於 C# 的 Bing 拼字檢查 SDK 開始進行拼字檢查。雖然 Bing 拼字檢查具有與大部分程式設計語言相容的 REST API，但 SDK 會提供簡單的方法，將服務整合到您的應用程式。此範例的原始程式碼可以在 GitHub 上找到。

應用程式相依性

Visual Studio 2017 或更新版本的任何版本。
Bing 拼字檢查 NuGet 套件

若要將 Bing 拼字檢查 SDK 新增至您的專案，請在 Visual Studio 中選取 [方案總管] 中的 [管理 NuGet 套件]。新增 Microsoft.Azure.CognitiveServices.Language.SpellCheck 套件。此套件也會安裝下列相依性：

Microsoft.Rest.ClientRuntime
Microsoft.Rest.ClientRuntime.Azure
Newtonsoft.Json

建立 Azure 資源

藉由建立下列其中一項 Azure 資源，開始使用 Bing 拼字檢查 API：

Bing 拼字檢查資源

您可以透過 Azure 入口網站取得該資源，直到將其刪除為止。
使用免費定價層來試用服務，之後可升級至付費層以用於實際執行環境。
Bing 拼字檢查 API 也會在 Bing 搜尋 v7 資源的某些層中提供。

多服務資源

您可以透過 Azure 入口網站取得該資源，直到將其刪除為止。
針對您的應用程式，跨多個 Azure AI 服務使用相同的金鑰和端點。

建立應用程式並將其初始化

在 Visual Studio 中建立新的 C# 主控台解決方案。然後新增下列 using 陳述式。

using System;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.Azure.CognitiveServices.Language.SpellCheck;
using Microsoft.Azure.CognitiveServices.Language.SpellCheck.Models;

建立新的類別。然後建立名為 SpellCheckCorrection() 的非同步函式，該函式會採用訂用帳戶金鑰並傳送拼字檢查要求。

建立新的 ApiKeyServiceClientCredentials 物件以具現化用戶端。

public static class SpellCheckSample{
    public static async Task SpellCheckCorrection(string key){
        var client = new SpellCheckClient(new ApiKeyServiceClientCredentials(key));
    }
    //...
}

傳送要求並讀取回應

在以上建立的函式中，執行下列步驟。透過用戶端傳送拼字檢查要求。將要檢查的文字新增至 text 參數，並將模式設定為 proof。
```
var result = await client.SpellCheckerWithHttpMessagesAsync(text: "Bill Gatas", mode: "proof");
```

取得第一個拼字檢查結果 (如果有的話)。列印所傳回的第一個拼錯的字組 (Token)、Token 類型和建議數目。

var firstspellCheckResult = result.Body.FlaggedTokens.FirstOrDefault();

if (firstspellCheckResult != null)
{
    Console.WriteLine("SpellCheck Results#{0}", result.Body.FlaggedTokens.Count);
    Console.WriteLine("First SpellCheck Result token: {0} ", firstspellCheckResult.Token);
    Console.WriteLine("First SpellCheck Result Type: {0} ", firstspellCheckResult.Type);
    Console.WriteLine("First SpellCheck Result Suggestion Count: {0} ", firstspellCheckResult.Suggestions.Count);
}

取得第一項建議的更正 (如果有的話)。列印建議分數，以及建議的字組。

var suggestions = firstspellCheckResult.Suggestions;

if (suggestions?.Count > 0)
{
    var firstSuggestion = suggestions.FirstOrDefault();
    Console.WriteLine("First SpellCheck Suggestion Score: {0} ", firstSuggestion.Score);
    Console.WriteLine("First SpellCheck Suggestion : {0} ", firstSuggestion.Suggestion);
}

執行應用程式

建置並執行專案。如果您使用 Visual Studio，請按 F5 來進行檔案偵錯。

後續步驟

建立單頁 Web 應用程式