So funktioniert es: Bing von .NET aus aufrufen

Mit einfachen Code-Schnipseln kann man die entscheidenden Schritte beim Schreiben einer Anwendung mit Bing-Schnittstelle bewältigen. ZDNet erklärt die Vorgehensweise und zeigt den Code.

Wer eine Suchmaschine in eine Anwendung integrieren will, sollte sich erst einmal für einen der drei führenden Anbieter entscheiden: Google, Yahoo oder Bing. Der Autor dieses Artikels hat sich für Bing entschieden, da ihm nach einem Vortrag des Programmierers Chris Eargle^[1] das Aufrufen von Bing von .Net aus am einfachsten erschien.

Um mit der Bing-API arbeiten zu können, muss man eine AppID von Microsoft anfordern^[2]. Mit dieser AppID übernimmt Visual Studio die WSDL und generiert automatisch die benötigten .NET-Klassen. Dazu sind folgende Schritte auszuführen (für Visual Studio 2008):

• Mit der rechten Maustaste auf die Projektreferenzen klicken und Add Service Reference auswählen.
• Danach die Schaltfläche Advanced drücken.
• Im dritten Schritt auf Add Web Reference klicken.
• Als URL http://api.bing.net/search.wsdl?AppID=IhreAppID&Version=2.2 eingeben. Darauf achten, dass hierbei die korrekte AppID verwendet wird.
• Gegebenenfalls kann man den Referenznamen ändern.
• Auf Go klicken und bei Abschluss des Prozesses Add Web Reference anklicken.

Wer möchte, kann auch XML^[3] oder JSON^[4] für den Zugriff auf Bing nutzen, obwohl die SOAP-Schnittstelle für den Großteil der .NET-Anwendungen am sinnvollsten ist, da Visual Studio gut mit SOAP-Services zusammenarbeitet. Nun kann es also losgehen. Um die neu erstellten Referenzen verwenden zu können, muss man die entsprechende using-Anweisung (für C#) oder Imports-Anweisung (für VB.NET) zu dem Code hinzufügen, der Bing verwenden soll. Der vollständige Name ist der Default-Namespace für das Projekt, plus die Service-Referenz. In diesem Fall ist der Namespace des Projekts TestProject, also sieht die Zeile zu seiner Einbindung wie folgt aus:

using TestProject.net.live.search.api;

Nun soll gezeigt werden, wie man eine Basisanfrage für Webergebnisse erstellt. Allerdings ist hierbei zu bedenken, dass Bing verschiedene Arten von Ergebnissen liefern kann, darunter Videos, Bilder und Telefonbücher. Mit einer Anfrage wird nach unterschiedlichen Typen gleichzeitig gesucht. Zur Übung kann man natürlich auch die anderen verfügbaren Suchtypen^[5] testen.

Alle Suchanfragen enthalten grundlegende Parameter und bieten zusätzlich eigene. Die erforderlichen Parameter lauten:

• AppID (String): Die auf die Anforderung zugeteilte AppID.
• Query (String): Die auszuführende Abfrage. Sie ist identisch mit der Eingabe, die man auf der Bing-Site zum Durchführen einer Suche machen würde.
• Sources (Sources[]): Eine Gruppe aus Sources (eine Aufzählung im Namespace), die angibt, welche Suchart(en) durchzuführen ist/sind.

Hier eine einfache Methode, um auf eine Anfrage hin eine Suche durchzuführen:

private void Lookup(string Query) { using (var service = new LiveSearchService()) { try { var request = new SearchRequest(); // Gemeinsame Request-Felder (erforderlich) request.AppId = "BingAppID"; request.Query = Query; request.Sources = new SourceType[] { SourceType.Web }; var response = service.Search(request); if (response.Web.Results == null) { return; } } catch (System.Web.Services.Protocols.SoapException ex) { // Exceptions erstmal ignorieren } catch (System.Net.WebException ex) { // Exceptions erstmal ignorieren } } }

Dies ist eine stark vereinfachte, modifizierte Version des Mustercodes in der Bing-Dokumentation. Mehr braucht man zur Durchführung einer Suche nicht.

Ab hier kann man mit den Ergebnissen der Abfrage arbeiten. Dazu ist LINQ sehr praktisch. In der Anwendung wird eine Results-Klasse erstellt, die nicht nur die aus Bing benötigten Informationen, sondern auch die Verarbeitung nach der Suche verkapselt. So bestückt man eine List mit einer einfachen LINQ-Abfrage:

results = (from result in response.Web.Results select new Result(result.Url, result.DisplayUrl, result.Title, 0, 0, new List<string>())).ToList();

Einige Einträge, mit denen die Result-Objekte in der Liste bestückt sind, stammen aus den Bing-Ergebnissen im Response-Objekt, andere wiederum sind einfach Initialisierungswerte, auf denen die spätere Verarbeitung aufbaut.

URLs in diesem Artikel:
[1] = http://www.kodefuguru.com/
[2] = http://www.bing.com/developers/createapp.aspx
[3] = http://msdn.microsoft.com/en-us/library/dd250893.aspx
[4] = http://msdn.microsoft.com/en-us/library/dd250846.aspx
[5] = http://msdn.microsoft.com/en-us/library/dd250847.aspx