Gewusst wie: Hinzufügen, Aktualisieren oder Entfernen eines Dienstverweises
Durch einen Dienstverweis kann ein Projekt auf einen oder mehrere Windows Communication Foundation (WCF)-Dienste zugreifen. Suchen Sie mithilfe des Dialogfelds Dienstverweis hinzufügen in der aktuellen Projektmappe, lokal, in einem lokalen Netzwerk oder im Internet nach WCF-Diensten.
Hinzufügen eines Dienstverweises
So fügen Sie einen Verweis auf einen externen Dienst hinzu
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.
Geben Sie im Feld Adresse die URL des Diensts ein, und klicken Sie dann auf Gehe zu, um nach dem Dienst zu suchen. Wenn der Dienst eine Benutzernamen-/Kennwortsicherheit implementiert, müssen Sie einen Benutzernamen und ein Kennwort eingeben.
Tipp
Sie sollten nur auf Dienste aus einer vertrauenswürdigen Quelle verweisen. Das Hinzufügen von Verweisen aus einer nicht vertrauenswürdigen Quelle kann die Sicherheit beeinträchtigen.
Tipp
Sie können die URL auch aus einer Dropdownliste auswählen, die die letzten 15 URLs speichert, unter denen gültige Dienstmetadaten gefunden wurden.
Während der Suche wird eine Statusanzeige angezeigt. Sie können die Suche jederzeit beenden, indem Sie auf die Schaltfläche Beenden klicken.
Erweitern Sie in der Liste Dienst den Knoten für den gewünschten Dienst, und wählen Sie einen Dienstvertrag aus.
Geben Sie im Feld Namespace den Namespace ein, den Sie für den Verweis verwenden möchten.
Klicken Sie auf OK, um dem Projekt den Verweis hinzuzufügen.
Ein Dienstclient (Proxy) wird generiert, und der Datei app.config werden Metadaten hinzugefügt, mit denen der Dienst beschrieben wird.
So fügen Sie der aktuellen Projektmappe einen Verweis auf einen Dienst hinzu
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.
Klicken Sie auf Ermitteln.
Der Liste Dienst werden alle WCF-Dienste der aktuellen Projektmappe hinzugefügt.
Erweitern Sie in der Liste Dienst den Knoten für den gewünschten Dienst, und wählen Sie einen Dienstvertrag aus.
Geben Sie im Feld Namespace den Namespace ein, den Sie für den Verweis verwenden möchten.
Klicken Sie auf OK, um dem Projekt den Verweis hinzuzufügen.
Ein Dienstclient (Proxy) wird generiert, und der Datei app.config werden Metadaten hinzugefügt, mit denen der Dienst beschrieben wird.
Aktualisieren eines Dienstverweises
Im Laufe der Zeit können sich die Metadaten für einen WCF-Dienst ändern. Daher muss der Dienstverweis gegebenenfalls aktualisiert werden.
So aktualisieren Sie einen Dienstverweis
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Dienstverweis, und klicken Sie dann auf Dienstverweis aktualisieren.
Ein Statusdialogfeld wird angezeigt während der Verweis vom ursprünglichen Speicherort aktualisiert wird. Der Dienstclient wird erneut generiert, um jede Änderung in den Metadaten widerzuspiegeln.
Entfernen eines Dienstverweises
Wenn ein Dienstverweis nicht mehr verwendet wird, können Sie ihn aus der Projektmappe entfernen.
So entfernen Sie einen Dienstverweis
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Dienstverweis, und klicken Sie dann auf Löschen.
Der Dienstclient wird aus der Projektmappe entfernt, und die Metadaten, die den Dienst beschreiben, werden aus der Datei app.config entfernt.
Tipp
Code, der auf den Dienstverweis verweist, muss manuell entfernt werden.
Siehe auch
Aufgaben
Gewusst wie: Hinzufügen eines Verweises auf einen Webdienst
Referenz
Dialogfeld "Dienstverweis hinzufügen"
Konzepte
Windows Communication Foundation-Dienste und WCF Data Services in Visual Studio