Início Rápido: Verificar a ortografia com o SDK de Verificação Ortográfica do Bing para C#

  • Artigo

Aviso

Em 30 de outubro de 2020, as APIs de Pesquisa do Bing foram migradas dos serviços de IA do Azure para os Serviços de Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter a documentação atualizada, consulte a documentação da API de pesquisa do Bing. Para obter instruções sobre como criar novos recursos do Azure para a Pesquisa do Bing, consulte Criar um recurso de Pesquisa do Bing por meio do Azure Marketplace.

Use este Início Rápido para iniciar a verificação ortográfica com o SDK de Verificação Ortográfica do Bing para C#. Embora a Verificação Ortográfica do Bing tenha uma API REST compatível com a maioria das linguagens de programação, o SDK fornece uma maneira fácil de integrar o serviço aos seus aplicativos. O código-fonte desta amostra pode ser encontrado no GitHub.

Dependências de aplicativo

Para adicionar o SDK de Verificação Ortográfica do Bing ao seu projeto, selecione Gerenciar Pacotes do NuGet no Gerenciador de Soluções do Visual Studio. Adicione o pacote Microsoft.Azure.CognitiveServices.Language.SpellCheck. O pacote também instala as seguintes dependências:

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

Criar um recurso do Azure

Comece usando a API de Verificação Ortográfica do Bing criando um dos seguintes recursos do Azure:

Recurso de Verificação Ortográfica do Bing

  • Disponível por meio do portal do Azure até que você exclua o recurso.
  • Use o tipo de preço gratuito para experimentar o serviço e atualize mais tarde para uma camada paga para produção.
  • A API de Verificação Ortográfica do Bing também é oferecida em algumas camadas do recurso Pesquisa do Bing v7.

Recurso de vários serviços

  • Disponível por meio do portal do Azure até que você exclua o recurso.
  • Use a mesma chave e ponto de extremidade para seus aplicativos nos vários serviços de IA do Azure.

Criar e inicializar o aplicativo

  1. Crie uma solução de console C# no Visual Studio. Em seguida, adicione a instrução using a seguir.

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

  2. Crie uma classe. Em seguida, crie uma função assíncrona chamada SpellCheckCorrection() que usa uma chave de assinatura e envia a solicitação de verificação ortográfica.

  3. Crie uma instância do cliente criando um objeto ApiKeyServiceClientCredentials.

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

Enviar a solicitação e ler a resposta

  1. Na função criada acima, execute as etapas a seguir. Envie a solicitação de verificação ortográfica com o cliente. Adicione o texto a ser verificado ao parâmetro text e defina o modo como proof.

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

  2. Obtenha o primeiro resultado da verificação ortográfica, se houver um. Imprima a primeira palavra com ortografia incorreta (token) retornada, o tipo de token e o número de sugestões.

    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. Obtenha a primeira correção sugerida, se houver. Imprima a pontuação de sugestão e a palavra sugerida.

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

Executar o aplicativo

Compile e execute seu projeto. Se você estiver usando o Visual Studio, pressione F5 para depurar o arquivo.

Próximas etapas

Criar um aplicativo Web de página única