Gewusst wie: Hinzufügen eines Verweises auf einen Webdienst

XML-Webdienste, auch als ASMX-Dienste bezeichnet, sind die Vorgänger von Windows Communication Foundation (WCF). Sie können auf Webdienste zugreifen, indem Sie, ähnlich wie bei anderen WCF-Diensten, einen Dienstverweis hinzufügen. Alle auf diese Art hinzugefügten Verweise verwenden die aktuelle .NET Framework-Version.

Zu Anwendungen, die mit einer früheren Visual Studio-Version erstellt wurden, können Sie dennoch einen Webverweis hinzufügen, der Version 2.0 von .NET Framework verwendet. Die Vorgehensweise dazu wird im folgenden Abschnitt beschrieben.

So fügen Sie einem Projekt einen Webverweis hinzu

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Namen des Projekts, dem der Dienst hinzugefügt werden soll. Klicken Sie dann auf Dienstverweis hinzufügen.

   Das Dialogfeld Dienstverweis hinzufügen wird angezeigt.

2. Klicken Sie im Dialogfeld Dienstverweis hinzufügen auf die Schaltfläche Erweitert.

   Das Dialogfeld Dienstverweiseinstellungen wird angezeigt.

3. Klicken Sie im Dialogfeld Dienstverweiseinstellungen auf Webverweis hinzufügen.

   Das Dialogfeld Webverweis hinzufügen wird angezeigt**.**

4. Geben Sie im Feld URL die URL des gewünschten Webdiensts ein. Wenn Sie die URL nicht kennen, verwenden Sie die Links im Browserbereich, um nach dem gewünschten Webdienst zu suchen.

   Hinweis

   Wenn Sie eine Webanwendung auf einem durch eine Firewall geschützten Computer entwickeln und die Anwendung Webdienste außerhalb der Firewall verwendet, müssen Sie in der URL auch Adresse und Anschluss des Netzwerkproxyservers angeben.Diesen Teil des URL-Pfads erhalten Sie vom Netzwerkadministrator.Weitere Informationen finden Sie unter Die Proxyeinstellungen auf diesem Computer sind nicht richtig zur Websuche konfiguriert..

5. Wählen Sie im Feld Unter dieser URL verfügbare Webdienste den gewünschten Webdienst aus.

6. Überprüfen Sie, ob der Webdienst für das Projekt verwendet werden kann und der bereitgestellte externe Code vertrauenswürdig ist.

   Sicherheitshinweis

   Wenn Sie ein Projekt zum Bearbeiten öffnen, das einen Webverweis enthält, wird durch einen von einem vertrauenswürdigen Benutzer (nämlich Ihnen) gestarteten Prozess von Devenv.exe eine lokale Proxydatei für den verwendeten Webdienst ausgeführt.Durch das Öffnen von Projekten oder Komponenten in der integrierten Entwicklungsumgebung (IDE) kann Code auf dem lokalen Computer ausgeführt werden.Weitere Informationen finden Sie unter Code Access Security.

7. Geben Sie im Feld Webverweisname einen Namen ein, der im Code für den programmgesteuerten Zugriff auf den ausgewählten Webdienst verwendet werden soll.

   Hinweis

   Standardmäßig wird Webverweisen ein Namespace zugewiesen, der ihrem Servernamen entspricht.Sie können diesen Wert ändern und einen benutzerdefinierten Namespacenamen eingeben.Namespacenamen unterliegen jedoch bestimmten Einschränkungen.Weitere Informationen über Zeichen, die in einem Webverweisnamen nicht zulässig sind, finden Sie unter Dialogfeld "Webverweis hinzufügen".Anhand des Webverweisnamens wird durch Erstellen einer geschachtelten Ordnerhierarchie ein Namespace erstellt.Im innersten Ordner wird eine WSDL-Datei erstellt, die auf den Webdienst verweist. Darüber hinaus werden unterstützende Dateien wie Discovery-Dateien (.disco und .discomap) erstellt, die Informationen über den Speicherort des Webdiensts enthalten.

8. Klicken Sie auf Verweis hinzufügen.

   Visual Studio erstellt einen WebReferences-Ordner, wennn ein solcher auf der Projektsite noch nicht vorhanden ist. Anschließend werden die für die Proxyklasse erforderlichen Dateien erstellt. Dabei wird der in Schritt 7 angegebene Name verwendet.

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen, Aktualisieren oder Entfernen eines Dienstverweises

Referenz

Dialogfeld "Dienstverweis hinzufügen"

Konzepte

Windows Communication Foundation-Dienste und WCF Data Services in Visual Studio

Web References in Visual Studio

Weitere Ressourcen

Consuming ASMX and WCF Services Sample