Gewusst wie: Hinzufügen und Entfernen von Webverweisen

Artikel
10/22/2014

Aktualisiert: November 2007

Durch einen Webverweis kann ein Projekt ein oder mehrere XML-Webdienste verwenden. Mit dem Dialogfeld "Webverweis hinzufügen" können Sie lokal, in einem lokalen Netzwerk oder im Internet nach Webdiensten suchen.

Nachdem Sie dem aktuellen Projekt einen Webverweis hinzugefügt haben, können Sie alle durch den Webdienst bereitgestellten Methoden aufrufen. Weitere Informationen finden Sie unter Gewusst wie: Aufrufen eines Webdiensts.

Informationen zum Erstellen einer Webdienstklasse finden Sie unter Exemplarische Vorgehensweise: Erstellen eines einfachen XML-Webdiensts mithilfe von ASP.NET.

So fügen Sie einem Projekt einen Webverweis hinzu

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

Das Dialogfeld Webverweis hinzufügen wird angezeigt.

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 in Visual Studio 2005 SDK unter "The proxy settings on this computer are not configured correctly for Web discovery".

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 in Visual Studio 2005 SDK unter "The proxy settings on this computer are not configured correctly for Web discovery".

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

Ü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 auf dem lokalen Computer Code ausgeführt werden. Weitere Informationen finden Sie unter Übersicht über Sicherheitsrisiken bei Webanwendungen und unter Codezugriffssicherheit.

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 auf dem lokalen Computer Code ausgeführt werden. Weitere Informationen finden Sie unter Übersicht über Sicherheitsrisiken bei Webanwendungen und unter Codezugriffssicherheit.

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". Visual Web Developer erstellt einen Namespace anhand des Webverweisnamens, indem eine geschachtelte Ordnerhierarchie erstellt wird. 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.

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". Visual Web Developer erstellt einen Namespace anhand des Webverweisnamens, indem eine geschachtelte Ordnerhierarchie erstellt wird. 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.

Klicken Sie auf Verweis hinzufügen.

Visual Studio erstellt den Ordner App_WebReferences, wenn dieser für die Website noch nicht vorhanden ist. Anschließend werden die für die Proxyklasse erforderlichen Dateien erstellt. Dabei wird der von Ihnen in Schritt 5 angegebene Name verwendet.

Entfernen eines Webverweises

Wenn im Projekt kein Webverweis auf einen XML-Webdienst mehr benötigt wird, können Sie den Verweis aus dem Projekt entfernen.

So entfernen Sie einen Webverweis aus einem Projekt

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Webverweis, und klicken Sie dann auf Löschen.

Alle Verweisinformationen werden aus dem Projekt und aus dem lokalen Speicher entfernt.

Siehe auch

Aufgaben

Gewusst wie: Aufrufen eines Webdiensts

Exemplarische Vorgehensweise: Erstellen und Verwenden eines ASP.NET-Webdiensts in Visual Web Developer

Exemplarische Vorgehensweise: Erstellen eines einfachen XML-Webdiensts mithilfe von ASP.NET

Konzepte

Übersicht über XML-Webdienste