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)

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Namen des Projekts, dem Sie den Dienst hinzufügen möchten, und klicken Sie dann auf Dienstverweis hinzufügen.

   Das Dialogfeld Dienstverweis hinzufügen wird angezeigt.

2. Geben Sie in das Feld Adresse die URL des Diensts ein, und klicken Sie dann auf Los, 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.

3. 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.

4. Geben Sie im Feld Namespace den Namespace ein, der für den Verweis verwendet werden soll.

5. 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)

1. Doppelklicken oder tippen Sie im Projektmappen-Explorer auf den Knoten Verbundene Dienste.

   Die Registerkarte Dienste konfigurieren wird geöffnet.

2. Wählen Sie Microsoft WCF Web Service Reference Provider aus.

   Das Dialogfeld WCF-Webdienstverweis konfigurieren wird geöffnet.

   

3. Geben Sie in das Feld URI die URL des Diensts ein, und klicken Sie dann auf Los, 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.

4. 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.

5. Geben Sie im Feld Namespace den Namespace ein, der für den Verweis verwendet werden soll.

6. 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)

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Namen des Projekts, dem Sie den Dienst hinzufügen möchten, und klicken Sie dann auf Dienstverweis hinzufügen.

   Das Dialogfeld Dienstverweis hinzufügen wird angezeigt.

2. Klicken Sie auf Ermitteln.

   Alle Dienste (sowohl WCF Data Services als auch WCF-Dienste) in der aktuellen Projektmappe werden der Liste Dienste hinzugefügt.

3. 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.

4. Geben Sie im Feld Namespace den Namespace ein, der für den Verweis verwendet werden soll.

5. 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)

1. Doppelklicken oder tippen Sie im Projektmappen-Explorer auf den Knoten Verbundene Dienste.

   Die Registerkarte Dienste konfigurieren wird geöffnet.

2. Wählen Sie Microsoft WCF Web Service Reference Provider aus.

   Das Dialogfeld WCF-Webdienstverweis konfigurieren wird geöffnet.

3. Klicken Sie auf Ermitteln.

   Alle Dienste (sowohl WCF Data Services als auch WCF-Dienste) in der aktuellen Projektmappe werden der Liste Dienste hinzugefügt.

4. 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.

5. Geben Sie im Feld Namespace den Namespace ein, der für den Verweis verwendet werden soll.

6. 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

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 dann auf Dienstverweis aktualisieren.

  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 klicken Sie dann auf Löschen.

  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.

Zugehöriger Inhalt

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