Gewusst wie: Hinzufügen, Aktualisieren oder Entfernen eines WCF-Datendienstverweises
Durch einen Dienstverweis kann ein Projekt auf einen oder mehrere WCF Data Services zugreifen. Suchen Sie mithilfe des Dialogfelds Dienstverweis hinzufügen in der aktuellen Projektmappe, lokal, in einem lokalen Netzwerk oder im Internet nach WCF Data Services.
Tipp
Ihr Computer zeigt möglicherweise für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.
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- und 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.
Sie können die URL auch aus der Liste Adresse auswählen, in der die letzten 15 URLs gespeichert sind, 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 Dienste den Knoten für den gewünschten Dienst, und wählen Sie eine Entitätenmenge 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.
Alle Dienste (sowohl WCF Data Services als auch WCF-Dienste) in der aktuellen Projektmappe werden der Liste Dienste hinzugefügt.
Erweitern Sie in der Liste Dienste den Knoten für den gewünschten Dienst, und wählen Sie eine Entitätenmenge 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
Das Entity Data Model für einen WCF Data Services ändert sich gelegentlich. Wenn dies geschieht, muss der Dienstverweis 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.