Schnellstart: Gewinnen von Erkenntnissen zu Bildern mit dem SDK für die visuelle Bing-Suche für C#Quickstart: Get image insights using the Bing Visual Search SDK for C#

Verwenden Sie diese Schnellstartanleitung, um über den Dienst für die visuelle Bing-Suche mithilfe des C# SDK Erkenntnisse zu Bildern zu gewinnen.Use this quickstart to begin getting image insights from the Bing Visual Search service, using the C# SDK. Die visuelle Bing-Suche 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.While Bing Visual Search has a REST API compatible with most programming languages, the SDK provides an easy way to integrate the service into your applications. Den Quellcode für dieses Beispiel finden Sie auf GitHub.The source code for this sample can be found on GitHub.

VoraussetzungenPrerequisites

  • Visual Studio 2019.Visual Studio 2019.
  • Unter Linux/macOS kann diese Anwendung mit Mono ausgeführt werdenIf you are using Linux/MacOS, this application can be run using Mono.
  • Das NuGet-Paket für die visuelle Suche.The NuGet Visual Search package.
    • Klicken Sie im Projektmappen-Explorer in Visual Studio mit der rechten Maustaste auf Ihr Projekt, und wählen Sie im Menü Manage NuGet Packages (NuGet-Pakete verwalten) aus.From the Solution Explorer in Visual Studio, right-click on your project and select Manage NuGet Packages from the menu. Installieren Sie das Microsoft.Azure.CognitiveServices.Search.VisualSearch-Paket.Install the Microsoft.Azure.CognitiveServices.Search.VisualSearch package. Bei der Installation der NuGet-Pakete wird auch Folgendes installiert:Installing the NuGet packages also installs the following:
      • Microsoft.Rest.ClientRuntimeMicrosoft.Rest.ClientRuntime
      • Microsoft.Rest.ClientRuntime.AzureMicrosoft.Rest.ClientRuntime.Azure
      • Newtonsoft.JsonNewtonsoft.Json

Sie benötigen ein Cognitive Services-API-Konto mit Zugriff auf die Bing-Suche-APIs.You must have a Cognitive Services API account with access to the Bing Search APIs. Falls Sie nicht über ein Azure-Abonnement verfügen, können Sie ein kostenloses Konto erstellen.If you don't have an Azure subscription, you can create an account for free. Vor dem Fortfahren benötigen Sie den Zugriffsschlüssel, der nach dem Aktivieren Ihrer kostenlosen Testversion bereitgestellt wird. Alternativ hierzu können Sie auch den Schlüssel eines kostenpflichtigen Abonnements aus Ihrem Azure-Dashboard verwenden.Before continuing, You will need the access key provided after activating your free trial, or a paid subscription key from your Azure dashboard.

Erstellen und Initialisieren der AnwendungCreate and initialize the application

  1. Erstellen Sie in Visual Studio ein neues Projekt.In Visual Studio, create a new project. Fügen Sie anschließend die folgenden Direktiven hinzu.Then add the following directives.

    using Microsoft.Azure.CognitiveServices.Search.VisualSearch;
    using Microsoft.Azure.CognitiveServices.Search.VisualSearch.Models;
    
  2. Instanziieren Sie den Client mit Ihrem Abonnementschlüssel.Instantiate the client with your subscription key.

    var client = new VisualSearchClient(new ApiKeyServiceClientCredentials("YOUR-ACCESS-KEY"));
    

Senden einer SuchanforderungSend a search request

  1. Erstellen Sie einen FileStream für Ihre Bilder (in diesem Fall TestImages/image.jpg).Create a FileStream to your images (in this case TestImages/image.jpg). Verwenden Sie anschließend den Client, um mit client.Images.VisualSearchMethodAsync() eine Suchanforderung zu senden.Then use the client to send a search request using client.Images.VisualSearchMethodAsync().

     System.IO.FileStream stream = new FileStream(Path.Combine("TestImages", "image.jpg"), FileMode.Open);
     // The knowledgeRequest parameter is not required if an image binary is passed in the request body
     var visualSearchResults = client.Images.VisualSearchMethodAsync(image: stream, knowledgeRequest: (string)null).Result;
    
  2. Analysieren Sie die Ergebnisse der vorherigen Abfrage:Parse the results of the previous query:

    // Visual Search results
    if (visualSearchResults.Image?.ImageInsightsToken != null)
    {
        Console.WriteLine($"Uploaded image insights token: {visualSearchResults.Image.ImageInsightsToken}");
    }
    else
    {
        Console.WriteLine("Couldn't find image insights token!");
    }
    
    // List of tags
    if (visualSearchResults.Tags.Count > 0)
    {
        var firstTagResult = visualSearchResults.Tags[0];
        Console.WriteLine($"Visual search tag count: {visualSearchResults.Tags.Count}");
    
        // List of actions in first tag
        if (firstTagResult.Actions.Count > 0)
        {
            var firstActionResult = firstTagResult.Actions[0];
            Console.WriteLine($"First tag action count: {firstTagResult.Actions.Count}");
            Console.WriteLine($"First tag action type: {firstActionResult.ActionType}");
        }
        else
        {
            Console.WriteLine("Couldn't find tag actions!");
        }
    }
    

Nächste SchritteNext steps