Hinzufügen, Aktualisieren oder Entfernen eines WCF-Datendienstverweises

Für .NET Framework-Projekte ermöglicht der Dienstverweis einem Projekt den Zugriff auf einen oder mehrere WCF Data Services.For .NET Framework projects, service reference enables a project to access one or more WCF Data Services. Verwenden Sie das Dialogfeld "Dienstreferenz hinzufügen ", um in der aktuellen Lösung lokal, in einem lokalen Netzwerk oder im Internet nach WCF Data Services zu suchen.

Für .NET Core-Projekte können Sie den Knoten "Verbundene Dienste " im Projektmappen-Explorer verwenden, um auf den Microsoft WCF-Webdienstverweisanbieter zuzugreifen, mit dem Sie Windows Communication Foundation (WCF)-Datendienstverweise verwalten können.

Hinweis

Auf Ihrem Computer werden möglicherweise unterschiedliche Namen oder Speicherorte für einige der Visual Studio-Benutzeroberflächenelemente in diesem Artikel angezeigt. 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 sind nicht mit dem .NET-Workload installiert, verwenden Sie den Visual Studio Installer, um Ihre Installation anzupassen. 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 (.NET Framework-Projekte) hinzu

1. 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 " Dienstreferenz hinzufügen " wird angezeigt.

2. Geben Sie im Feld "Adresse " die URL für den Dienst ein, und wählen Sie dann "Gehe zu" aus, um nach dem Dienst zu suchen. Wenn der Dienst Benutzernamen und Kennwortsicherheit implementiert, werden Sie möglicherweise aufgefordert, einen Benutzernamen und ein Kennwort einzugeben. Sie können auch einen Dienst in Ihrer eigenen Lösung auswählen. Klicken Sie auf die Schaltfläche " Entdecken ", und wählen Sie dann "Dienste in Lösung" aus.

   Hinweis

   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 auch die URL aus der Adressliste auswählen, die die vorherigen 15 URLs speichert, bei denen gültige Dienstmetadaten gefunden wurden.

   Eine Statusleiste wird angezeigt, wenn die Suche ausgeführt wird. 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 einen Entitätssatz aus.

4. Geben Sie im Feld "Namespace " den Namespace ein, den Sie für den Verweis verwenden möchten.

5. Klicken Sie auf "OK ", um den Verweis zum Projekt hinzuzufügen.

   Ein Dienstclient (Proxy) wird generiert, und Metadaten, die den Dienst beschreiben, werden der app.config Datei hinzugefügt.

So fügen Sie einen Verweis auf einen externen Dienst (.NET Core-Projekte, einschließlich .NET 5 und höher) hinzu

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

   Die Registerkarte " Dienste konfigurieren " wird geöffnet.

2. Wählen Sie den Microsoft WCF-Webdienstverweisanbieter aus.

   Das Dialogfeld "WCF-Webdienstreferenz konfigurieren " wird angezeigt.

   

3. Geben Sie im URI-Feld die URL für den Dienst ein, und wählen Sie dann "Gehe " aus, um nach dem Dienst zu suchen. Wenn der Dienst Benutzernamen und Kennwortsicherheit implementiert, werden Sie möglicherweise aufgefordert, einen Benutzernamen und ein Kennwort einzugeben.

   Hinweis

   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 auch die URL aus der URI-Liste auswählen, in der die vorherigen 15 URLs gespeichert werden, bei denen gültige Dienstmetadaten gefunden wurden.

   Eine Statusleiste wird angezeigt, wenn die Suche ausgeführt wird. 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 einen Entitätssatz aus.

5. Geben Sie im Feld "Namespace " den Namespace ein, den Sie für den Verweis verwenden möchten.

6. Klicken Sie auf "Fertig stellen ", um den Verweis auf das Projekt hinzuzufügen.

   Ein Dienstclient (Proxy) wird generiert, und Metadaten, die den Dienst beschreiben, werden der app.config Datei hinzugefügt.

So fügen Sie einen Verweis auf einen Dienst in der aktuellen Lösung (.NET Framework-Projekte) hinzu

1. 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 " Dienstreferenz hinzufügen " wird angezeigt.

2. Klicken Sie auf "Entdecken".

   Alle Dienste (sowohl WCF Data Services als auch WCF-Dienste) in der aktuellen Lösung werden der Dienstliste hinzugefügt.

3. Erweitern Sie in der Liste "Dienste " den Knoten für den Dienst, den Sie verwenden möchten, und wählen Sie einen Entitätssatz aus.

4. Geben Sie im Feld "Namespace " den Namespace ein, den Sie für den Verweis verwenden möchten.

5. Klicken Sie auf "OK ", um den Verweis zum Projekt hinzuzufügen.

   Ein Dienstclient (Proxy) generiert und Metadaten, die den Dienst beschreiben, werden der app.config Datei hinzugefügt.

So fügen Sie einen Verweis auf einen Dienst in der aktuellen Lösung (.NET Core-Projekte) hinzu

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

   Die Registerkarte " Dienste konfigurieren " wird geöffnet.

2. Wählen Sie den Microsoft WCF-Webdienstverweisanbieter aus.

   Das Dialogfeld "WCF-Webdienstreferenz konfigurieren " wird angezeigt.

3. Klicken Sie auf "Entdecken".

   Alle Dienste (sowohl WCF Data Services als auch WCF-Dienste) in der aktuellen Lösung werden der Dienstliste hinzugefügt.

4. Erweitern Sie in der Liste "Dienste " den Knoten für den Dienst, den Sie verwenden möchten, und wählen Sie einen Entitätssatz aus.

5. Geben Sie im Feld "Namespace " den Namespace ein, den Sie für den Verweis verwenden möchten.

6. Klicken Sie auf "Fertig stellen ", um den Verweis auf das Projekt hinzuzufügen.

   Ein Dienstclient (Proxy) generiert und Metadaten, die den Dienst beschreiben, werden der app.config Datei hinzugefügt.

Aktualisieren einer Dienstreferenz

Das Entitätsdatenmodell für wcf Data Services ändert sich manchmal. In diesem Fall müssen Sie den Dienstverweis aktualisieren.

So aktualisieren Sie einen Dienstverweis

Verwenden Sie für .NET Core-Projekte das dotnet-svcutil Tool. Installations- und Anweisungen 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 Dienstreferenz aktualisieren aus.

  Ein Fortschrittsdialogfeld wird angezeigt, während der Verweis von seinem ursprünglichen Speicherort aktualisiert wird, und der Dienstclient wird neu generiert, um Änderungen in den Metadaten widerzuspiegeln.

Entfernen eines Dienstverweises

Wenn kein Dienstverweis mehr verwendet wird, können Sie ihn aus Ihrer Lösung 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 Lösung entfernt, und die Metadaten, die den Dienst beschreiben, werden aus der app.config-Datei entfernt.

  Hinweis

  Jeder Code, der auf den Dienstverweis verweist, muss manuell entfernt werden.

Verwandte Inhalte

• Windows Communication Foundation Services und WCF-Datendienste in Visual Studio