Schnellstart: Überprüfen der Rechtschreibung mit dem SDK für die Bing-Rechtschreibprüfung für C#

  • Artikel

Warnung

Am 30. Oktober 2020 wurden die Bing-Suche-APIs aus den Azure KI Services in die Bing-Suchdienste verschoben. Diese Dokumentation wird nur zu Referenzzwecken bereitgestellt. Eine aktualisierte Dokumentation finden Sie in der Dokumentation zu den Bing-Suche-APIs. Anweisungen zum Erstellen neuer Azure-Ressourcen für die Bing-Suche finden Sie unter Erstellen einer Ressource für die Bing-Suche über Azure Marketplace.

Verwenden Sie diese Schnellstartanleitung, um mit dem SDK für die Bing-Rechtschreibprüfung für C# mit der Rechtschreibprüfung zu beginnen. Die Bing-Rechtschreibprüfung verfügt zwar über eine REST-API, die mit den meisten Programmiersprachen kompatibel ist, aber das SDK ist eine einfache Möglichkeit, den Dienst in Ihre Anwendungen zu integrieren. Den Quellcode für dieses Beispiel finden Sie auf GitHub.

Anwendungsabhängigkeiten

Wählen Sie in Visual Studio im Projektmappen-Explorer die Option NuGet-Pakete verwalten aus, um Ihrem Projekt das SDK für die Bing-Rechtschreibprüfung hinzuzufügen. Fügen Sie das Paket Microsoft.Azure.CognitiveServices.Language.SpellCheck hinzu. Mit dem Paket werden auch die folgenden Abhängigkeiten installiert:

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

Erstellen einer Azure-Ressource

Beginnen Sie mit der Verwendung der Bing-Rechtschreibprüfung-API, indem Sie eine der folgenden Azure-Ressourcen erstellen:

Bing-Rechtschreibprüfung-Ressource

  • Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
  • Verwenden Sie den Tarif „Free“, um den Dienst zu testen, und führen Sie später für die Produktion ein Upgrade auf einen kostenpflichtigen Tarif durch.
  • Die Bing-Rechtschreibprüfung-API wird auch in einigen Tarifen der Bing-Suche v7-Ressource angeboten.

Ressource für mehrere Dienste

  • Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
  • Verwenden Sie in allen Azure KI Services-Instanzen denselben Schlüssel und Endpunkt für Ihre Anwendungen.

Erstellen und Initialisieren der Anwendung

  1. Erstellen Sie in Visual Studio eine neue C#-Konsolenprojektmappe. Fügen Sie anschließend die folgende using-Anweisung hinzu.

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

  2. Erstellen Sie eine neue Klasse. Erstellen Sie dann eine asynchrone Funktion mit dem Namen SpellCheckCorrection(), für die ein Abonnementschlüssel verwendet und die Rechtschreibprüfungsanforderung gesendet wird.

  3. Instanziieren Sie den Client, indem Sie ein neues ApiKeyServiceClientCredentials-Objekt erstellen.

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

Senden der Anforderung und Lesen der Antwort

  1. Führen Sie in der oben erstellten Funktion die folgenden Schritte aus. Senden Sie die Rechtschreibprüfungsanforderung mit dem Client. Fügen Sie den zu überprüfenden Text dem Parameter text hinzu, und legen Sie den Modus auf proof fest.

    var result = await client.SpellCheckerWithHttpMessagesAsync(text: "Bill Gatas", mode: "proof");

  2. Rufen Sie, falls vorhanden, das erste Rechtschreibprüfungsergebnis ab. Geben Sie das erste zurückgegebene fehlerhafte Wort (Token), den Tokentyp und die Anzahl von Vorschlägen aus.

    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);
}

  3. Rufen Sie die erste vorgeschlagene Korrektur ab, sofern vorhanden. Geben Sie die Bewertungspunktzahl des Vorschlags und das erste vorgeschlagene Wort aus.

    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);
}

Ausführen der Anwendung

Erstellen Sie Ihr Projekt, und führen Sie es aus. Wenn Sie Visual Studio verwenden, drücken Sie F5, um die Datei zu debuggen.

Nächste Schritte

Erstellen einer Single-Page-Web-App