Guía de inicio rápido: Búsqueda de imágenes con el SDK de Bing Image Search para C#Quickstart: Search for images with the Bing Image Search SDK for C#

Use este inicio rápido para buscar su primera imagen con el SDK de Bing Image Search, un contenedor de la API y que contiene las mismas características.Use this quickstart to make your first image search using the Bing Image Search SDK, which is a wrapper for the API and contains the same features. Esta sencilla aplicación de C# envía una consulta de búsqueda de imagen, analiza la respuesta de JSON y muestra la dirección URL de la primera imagen devuelta.This simple C# application sends an image search query, parses the JSON response, and displays the URL of the first image returned.

El código fuente de este ejemplo está disponible en GitHub con anotaciones y control de errores adicionales.The source code for this sample is available on GitHub with additional error handling and annotations.

Requisitos previosPrerequisites

Para instalar el SDK de Bing Image Search en Visual Studio, use la opción Administrar paquetes NuGet del Explorador de soluciones.To install the Bing Image Search SDK in Visual Studio, use the Manage NuGet Packages option from Solution Explorer.

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.

Consulte también Precios de Cognitive Services - Bing Search API.See also Cognitive Services Pricing - Bing Search API.

Creación e inicialización de la aplicaciónCreate and initialize the application

En primer lugar, cree una aplicación de consola en C# mediante Visual Studio.First, create a new C# console application in Visual Studio. Agregue los siguientes paquetes al proyecto.Then add the following packages to your project.

using System;
using System.Linq;
using Microsoft.Azure.CognitiveServices.Search.ImageSearch;
using Microsoft.Azure.CognitiveServices.Search.ImageSearch.Models;

En el método principal del proyecto, cree variables para la clave de suscripción válida, los resultados de imágenes que Bing devolverá y un término de búsqueda.In the main method of your project, create variables for your valid subscription key, the image results to be returned by Bing, and a search term. Luego, use la clave para crear instancias del cliente de búsqueda de imagen.Then instantiate the image search client using the key.

//IMPORTANT: replace this variable with your Cognitive Services subscription key
string subscriptionKey = "ENTER YOUR KEY HERE";
//stores the image results returned by Bing
Images imageResults = null;
// the image search term to be used in the query
string searchTerm = "canadian rockies";

//initialize the client
//NOTE: If you're using version 1.2.0 or below for the Bing Image Search SDK, 
// use ImageSearchAPI() instead of ImageSearchClient() to initialize your search client.

var client = new ImageSearchClient(new ApiKeyServiceClientCredentials(subscriptionKey));

Envío de una consulta de búsqueda con el clienteSend a search query using the client

Utilice al cliente para buscar con un texto de consulta:Use the client to search with a query text:

// make the search request to the Bing Image API, and get the results"
imageResults = client.Images.SearchAsync(query: searchTerm).Result; //search query

Análisis y visualización del primer resultado de la imagenParse and view the first image result

Analice los resultados de la imagen devueltos en la respuesta.Parse the image results returned in the response. Si la respuesta contiene resultados de la búsqueda, almacene el primer resultado e imprima sus detalles, como la dirección URL de una miniatura, la dirección URL original, además del número total de imágenes devueltas.If the response contains search results, store the first result and print out its details, such as a thumbnail URL, the original URL,along with the total number of returned images.

if (imageResults != null)
{
    //display the details for the first image result.
    var firstImageResult = imageResults.Value.First();
    Console.WriteLine($"\nTotal number of returned images: {imageResults.Value.Count}\n");
    Console.WriteLine($"Copy the following URLs to view these images on your browser.\n");
    Console.WriteLine($"URL to the first image:\n\n {firstImageResult.ContentUrl}\n");
    Console.WriteLine($"Thumbnail URL for the first image:\n\n {firstImageResult.ThumbnailUrl}");
    Console.ReadKey();
}

Pasos siguientesNext steps

Otras referenciasSee also