Envío de una solicitud de búsqueda el SDK de Bing Entity Search para C#Send a search request with the Bing Entity Search SDK for C#

Use este inicio rápido para empezar a buscar entidades con el SDK de Bing Entity Search para C#.Use this quickstart to begin searching for entities with the Bing Entity Search SDK for C#. Aunque Bing Entity Search tiene una API REST compatible con la mayoría de los lenguajes de programación, el SDK proporciona una forma sencilla de integrar el servicio en sus aplicaciones.While Bing Entity Search has a REST API compatible with most programming languages, the SDK provides an easy way to integrate the service into your applications. El código fuente de este ejemplo está disponible en GitHub.The source code for this sample can be found on GitHub.

Requisitos previosPrerequisites

Para añadir el SDK de Bing Entity Search al proyecto de Visual Studio, use la opción Administración de paquetes de NuGet del Explorador de soluciones y agregue el paquete Microsoft.Azure.CognitiveServices.Search.EntitySearch.To add the Bing Entity Search SDK to your Visual Studio project, use the Manage NuGet Packages option from Solution Explorer, and add the Microsoft.Azure.CognitiveServices.Search.EntitySearch package.

Debe tener una cuenta de Cognitive Services API con acceso a Bing Search APIs.You must have a Cognitive Services API account with access to the Bing Search APIs. Si no tiene una suscripción de Azure, puede crear una cuenta gratuita.If you don't have an Azure subscription, you can create an account for free. Antes de continuar, necesitará la clave de acceso que se le proporcionó al activar la versión de evaluación gratuita o puede usar una clave de suscripción de pago desde el panel de Azure.Before continuing, You will need the access key provided after activating your free trial, or a paid subscription key from your Azure dashboard.

Creación e inicialización de una aplicaciónCreate and initialize an application

  1. Cree una solución de consola de C# en Visual Studio.create a new C# console solution in Visual Studio. Después, agregue lo siguiente en el archivo de código principal.Then add the following into the main code file.

    using System;
    using System.Linq;
    using System.Text;
    using Microsoft.Azure.CognitiveServices.Search.EntitySearch;
    using Microsoft.Azure.CognitiveServices.Search.EntitySearch.Models;
    using Newtonsoft.Json;
    

Creación de un cliente y envío de una solicitud de búsquedaCreate a client and send a search request

  1. Cree un cliente de búsqueda.Create a new search client. Agregue su clave de suscripción mediante la creación de un nuevo ApiKeyServiceClientCredentials.Add your subscription key by creating a new ApiKeyServiceClientCredentials.

    var client = new EntitySearchAPI(new ApiKeyServiceClientCredentials("YOUR-ACCESS-KEY"));
    
  2. Use la función Entities.Search() del cliente para buscar la consulta:Use the client's Entities.Search() function to search for your query:

    var entityData = client.Entities.Search(query: "Satya Nadella");
    

Obtención e impresión de una descripción de entidadGet and print an entity description

  1. Si la API devolvió los resultados de la búsqueda, obtenga la entidad principal de entityData.If the API returned search results, get the main entity from entityData.

    var mainEntity = entityData.Entities.Value.Where(thing => thing.EntityPresentationInfo.EntityScenario == EntityScenario.DominantEntity).FirstOrDefault();
    
  2. Impresión de la descripción de la entidad principalPrint the description of the main entity

    Console.WriteLine(mainEntity.Description);
    

Pasos siguientesNext steps