Hinzufügen, Aktualisieren oder Entfernen eines WCF-Datendienstverweises
Bei .NET Framework-Projekten ermöglicht ein Dienstverweis einem Projekt den Zugriff auf eine oder mehrere WCF Data Services-Instanzen. Verwenden Sie das Dialogfeld Dienstverweis hinzufügen, um lokal, in der aktuellen Projektmappe, in einem lokalen Netzwerk oder im Internet nach WCF Data Services zu suchen.
Für .NET Core-Projekte können Sie über den Knoten Verbundene Dienste im Projektmappen-Explorer auf den Microsoft WCF Web Service Reference Provider zuzugreifen, mit dem Sie Windows Communication Foundation-Datendienstverweise (WCF) verwalten können.
Hinweis
Auf Ihrem Computer werden möglicherweise andere Namen oder Speicherorte für die Benutzeroberflächenelemente von Visual Studio angezeigt als die in diesem Artikel. Möglicherweise verwenden Sie eine andere Edition von Visual Studio oder andere Umgebungseinstellungen. Weitere Informationen finden Sie unter Personalisieren der IDE.
Voraussetzungen
Die WCF-Tools werden nicht mit der .NET-Workload installiert. Verwenden Sie den Visual Studio-Installer, um Ihre Installation zu ändern. Wählen Sie im Installationsprogramm unter Einzelne Komponenten die Option Windows Communication Foundation aus. Weitere Informationen finden Sie im Artikel Ändern von Visual Studio durch Hinzufügen oder Entfernen von Arbeitsauslastungen und Komponenten.
Hinzufügen eines WCF-Dienstverweises
So fügen Sie einen Verweis auf einen externen Dienst hinzu (.NET Framework-Projekte)
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Namen des Projekts, dem Sie den Dienst hinzufügen möchten, und wählen Sie dann Dienstverweis hinzufügen aus.
Das Dialogfeld Dienstverweis hinzufügen wird angezeigt.
Geben Sie im Feld Adresse die URL für den Dienst ein, und wählen Sie Los aus, um nach dem Dienst zu suchen. Wenn der Dienst Sicherheit per Benutzername und Kennwort implementiert, werden Sie möglicherweise nach einem Benutzernamen und einem Kennwort gefragt. Sie können auch einen Dienst in Ihrer eigenen Projektmappe auswählen. Wählen Sie die Schaltfläche Ermitteln und dann Dienste in Projektmappe aus.
Hinweis
Sie sollten nur auf Dienste aus einer vertrauenswürdigen Quelle verweisen. Wenn Sie Verweise aus nicht vertrauenswürdigen Quellen hinzufügen, hat das möglicherweise Auswirkungen auf die Sicherheit.
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 eingeblendet. Sie können die Suche jederzeit beenden, indem Sie auf Beenden klicken.
Erweitern Sie in der Liste Dienste den Knoten für den Dienst, den Sie verwenden möchten, und wählen Sie eine Entitätenmenge aus.
Geben Sie im Feld Namespace den Namespace ein, der für den Verweis verwendet werden soll.
Klicken Sie auf OK, um dem Projekt den Verweis hinzuzufügen.
Es wird ein Dienstclient (Proxy) generiert, und der Datei app.config werden Metadaten hinzugefügt, die den Dienst beschreiben.
So fügen Sie einen Verweis auf einen externen Dienst hinzu (.NET Core-Projekte, einschließlich .NET 5 und höher)
Doppelklicken oder tippen Sie im Projektmappen-Explorer auf den Knoten Verbundene Dienste.
Die Registerkarte Dienste konfigurieren wird geöffnet.
Wählen Sie Microsoft WCF Web Service Reference Provider aus.
Das Dialogfeld WCF-Webdienstverweis konfigurieren wird geöffnet.
Geben Sie im Feld URI die URL für den Dienst ein, und wählen Sie Los aus, um nach dem Dienst zu suchen. Wenn der Dienst Sicherheit per Benutzername und Kennwort implementiert, werden Sie möglicherweise nach einem Benutzernamen und einem Kennwort gefragt.
Hinweis
Sie sollten nur auf Dienste aus einer vertrauenswürdigen Quelle verweisen. Wenn Sie Verweise aus nicht vertrauenswürdigen Quellen hinzufügen, hat das möglicherweise Auswirkungen auf die Sicherheit.
Sie können die URL auch aus der Liste URI auswählen, in der die letzten 15 URLs gespeichert sind, unter denen gültige Dienstmetadaten gefunden wurden.
Während der Suche wird eine Statusanzeige eingeblendet. Sie können die Suche jederzeit beenden, indem Sie auf Beenden klicken.
Erweitern Sie in der Liste Dienste den Knoten für den Dienst, den Sie verwenden möchten, und wählen Sie eine Entitätenmenge aus.
Geben Sie im Feld Namespace den Namespace ein, der für den Verweis verwendet werden soll.
Klicken Sie auf Fertig stellen, um dem Projekt den Verweis hinzuzufügen.
Es wird ein Dienstclient (Proxy) generiert, und der Datei app.config werden Metadaten hinzugefügt, die den Dienst beschreiben.
So fügen Sie einen Verweis auf einen Dienst in der aktuellen Projektmappe hinzu (.NET Framework-Projekte)
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Namen des Projekts, dem Sie den Dienst hinzufügen möchten, und wählen Sie dann Dienstverweis hinzufügen aus.
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 Dienst, den Sie verwenden möchten, und wählen Sie eine Entitätenmenge aus.
Geben Sie im Feld Namespace den Namespace ein, der für den Verweis verwendet werden soll.
Klicken Sie auf OK, um dem Projekt den Verweis hinzuzufügen.
Es wird ein Dienstclient (Proxy) generiert, und der Datei app.config werden Metadaten hinzugefügt, die den Dienst beschreiben.
So fügen Sie einen Verweis auf einen Dienst in der aktuellen Projektmappe hinzu (.NET Core-Projekte)
Doppelklicken oder tippen Sie im Projektmappen-Explorer auf den Knoten Verbundene Dienste.
Die Registerkarte Dienste konfigurieren wird geöffnet.
Wählen Sie Microsoft WCF Web Service Reference Provider aus.
Das Dialogfeld WCF-Webdienstverweis konfigurieren wird geöffnet.
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 Dienst, den Sie verwenden möchten, und wählen Sie eine Entitätenmenge aus.
Geben Sie im Feld Namespace den Namespace ein, der für den Verweis verwendet werden soll.
Klicken Sie auf Fertig stellen, um dem Projekt den Verweis hinzuzufügen.
Es wird ein Dienstclient (Proxy) generiert, und der Datei app.config werden Metadaten hinzugefügt, die den Dienst beschreiben.
Aktualisieren eines Dienstverweises
Das Entity Data Model für eine WCF Data Services-Instanz ändert sich gelegentlich. In diesem Fall müssen Sie den Dienstverweis aktualisieren.
So aktualisieren Sie einen Dienstverweis
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Dienstverweis, und wählen Sie dann Dienstverweis aktualisieren aus.
Während der Aktualisierung des Verweises vom ursprünglichen Speicherort wird ein Fortschrittsdialogfeld angezeigt, und der Dienstclient wird neu generiert, um alle Änderungen in den Metadaten widerzuspiegeln.
Verwenden Sie für .NET Core-Projekte das Tool dotnet-svcutil. Anweisungen zur Installation finden Sie unter dotnet-svcutil.
Für .NET Framework-Projekte:
Erweitern Sie im Projektmappen-Explorer den Knoten Verbundene Dienste, klicken Sie mit der rechten Maustaste auf den Dienstverweis, und wählen Sie dann Dienstverweis aktualisieren aus.
Während der Aktualisierung des Verweises vom ursprünglichen Speicherort wird ein Fortschrittsdialogfeld angezeigt, und der Dienstclient wird neu generiert, um alle Änderungen in den Metadaten widerzuspiegeln.
Entfernen eines Dienstverweises
Wenn ein Dienstverweis nicht mehr verwendet wird, können Sie ihn aus Ihrer Projektmappe entfernen.
So entfernen Sie einen Dienstverweis
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Dienstverweis, und wählen Sie dann Löschen aus.
Der Dienstclient wird aus der Projektmappe entfernt, und die Metadaten zur Beschreibung des Diensts werden aus der app.config-Datei entfernt.
Hinweis
Jeder Codeabschnitt, der den Dienstverweis referenziert, muss manuell entfernt werden.