Verwenden des Provider-Tools für den WCF-Webdienstverweis

Im Laufe der Jahre konnten viele Visual Studio-Entwickler von dem Dienstverweis hinzufügen-Tool profitieren und ihre Produktivität steigern, wenn sie für ihre .NET Framework-Projekte Zugriff auf Webdienste benötigten.

Das Tool WCF Web Service Reference ist eine mit Visual Studio verbundene Diensterweiterung, mit der Sie Ihr .NET 5+-, .NET Core- oder ASP.NET Core-Projekt mit einem Webdienst verbinden können. Es bietet eine ähnliche Funktionalität wie Dienstverweis hinzufügen, die nur für .NET Framework-Projekte gedacht ist. Das Tool WCF Web Service Reference ruft Metadaten von einem Webdienst in der aktuellen Projektmappe, von einer Netzwerkadresse oder aus einer WSDL-Datei ab und generiert eine Quelldatei. Diese enthält den Proxycode des WCF-Clients (Windows Communication Foundation), über den Ihre .NET-App auf einen Webdienst zuzugreifen kann.

Wichtig

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.

Voraussetzungen

• Mindestens Visual Studio 2017, Version 15.5

Die Screenshots in diesem Artikel stammen aus Visual Studio 2022.

Verwenden der Erweiterung

Hinweis

Das Tool WCF Web Service Reference eignet sich nur für C# .NET Core- und .NET Standard-Projekte, einschließlich ASP.NET Core-Web-Apps.

In diesem Artikel wird die Projektvorlage ASP.NET Core-Webanwendung als Beispiel genommen, um Ihnen exemplarisch zu erläutern, wie Sie einem Projekt einen WCF-Dienstverweis hinzufügen.

1. Doppelklicken Sie in Projektmappen-Explorer auf den Knoten Verbundene Dienste des Projekts. (Klicken Sie für ein .NET Core- oder .NET Standard-Projekt mit der rechten Maustaste auf das Projekt, und wählen Sie Hinzufügen>Verbundener Dienst aus.)

   Die Seite Verbundene Dienste wird wie in der folgenden Abbildung dargestellt angezeigt:

   

2. Wählen Sie auf der Seite Verbundene Dienste die Option Dienstverweis hinzufügen aus.

   Die Seite Dienstverweis hinzufügen wird geöffnet.

3. Wählen Sie WCF-Webdienst und dann Weiter aus.

   Dadurch wird der Assistent zum Hinzufügen eines Dienstverweises auf den WCF-Webdienst eingeblendet.

   

4. Wählen Sie einen Dienst aus.

   a. Es stehen mehrere Suchoptionen für Dienste zur Verfügung:

   • Klicken Sie auf die Schaltfläche Ermitteln, um nach Diensten zu suchen, die in der aktuellen Projektmappe definiert sind.
   • Geben Sie eine Dienst-URL im Feld Adresse ein, und klicken Sie auf die Schaltfläche Gehe zu, um nach Diensten zu suchen, die an einer bestimmten Adresse gehostet werden.
   • Klicken Sie auf die Schaltfläche Durchsuchen, um eine WSDL-Datei auszuwählen, die die Metadateninformationen des Webdiensts enthält.

   b. Wählen Sie den Dienst aus der Liste der Suchergebnisse im Feld Dienste aus. Geben Sie ggf. den Namespace für den generierten Code im entsprechenden Textfeld Namespace ein.

   c. Klicken Sie auf die Schaltfläche Weiter, um Datentyp- oder Clientoptionen anzugeben. Sie können stattdessen auch auf die Schaltfläche Fertig stellen klicken, um die Standardoptionen zu verwenden.

5. Auf der Seite Datentypoptionen können Sie die generierten Konfigurationseinstellungen für die Dienstverweise neu festlegen:

   

   Hinweis

   Die Kontrollkästchenoption Typen in Assemblys, auf die verwiesen wird, wiederverwenden ist nützlich, wenn Datentypen, die für die Codegenerierung für Dienstverweise benötigt werden, in einer der Assemblys definiert werden, auf die Ihr Projekt verweist. Es ist wichtig, dass Sie die vorhandenen Datentypen wiederverwenden, um Typkollisionen oder Probleme mit der Runtime zur Kompilierzeit zu vermeiden.

   Es kann zu Verzögerungen kommen, während die Typinformationen geladen werden. Dies ist von der Anzahl von Projektabhängigkeiten und anderen die Systemleistung betreffenden Faktoren abhängig. Die Schaltfläche Fertig stellen wird beim Laden deaktiviert. Dies ist nicht der Fall, wenn das Kontrollkästchen Typen in Assemblys, auf die verwiesen wird, wiederverwenden deaktiviert ist.

6. Klicken Sie auf Fertig stellen, wenn Sie so weit sind.

Das Tool führt folgende Schritte aus, während es den Fortschritt anzeigt:

• Metadaten werden von dem WCF-Dienst heruntergeladen.
• Der Dienstverweiscode in einer Datei mit dem Namen reference.cs wird generiert und Ihrem Projekt unter dem Knoten Verbundene Dienste hinzugefügt.
• Aktualisiert die Projektdatei (.csproj) mit NuGet-Paketverweisen, die erforderlich sind, damit diese Datei auf der Zielplattform kompiliert und ausgeführt werden kann.

Nachdem die Prozesse abgeschlossen sind, können Sie eine Instanz des generierten WCF-Clienttyps generieren und die Dienstvorgänge ausrufen.

Weitere Informationen

• Erste Schritte mit Windows Communication Foundation-Anwendungen
• Windows Communication Foundation-Dienste und WCF Data Services in Visual Studio
• Von WCF unterstützte Features in .NET Core

Feedback und Fragen

Wenn Sie uns Feedback zum Produkt geben möchten, können Sie dies in der Entwicklercommunity mithilfe des Tools Problem melden tun.

Anmerkungen zu diesem Release

• Aktualisierte Informationen zu den einzelnen Versionen, einschließlich bekannter Probleme, finden Sie in den Anmerkungen zu den jeweiligen Versionen.