Verwenden des WCF-Webdienstverweisanbietertools

Im Laufe der Jahre haben viele Visual Studio-Entwickler die Produktivität genossen, die das Tool "Dienstreferenz hinzufügen" bereitgestellt hat, wenn ihre .NET Framework-Projekte für den Zugriff auf Webdienste erforderlich sind.

Das WCF-Webdienstverweistool ist eine mit Visual Studio verbundene Diensterweiterung, mit der Sie Ihre .NET 5+-, .NET Core- oder ASP.NET Core-Projekt mit einem Webdienst verbinden können. Es bietet eine Oberfläche, die der Funktionalität zum Hinzufügen von Dienstreferenzen ähnelt, die nur für .NET Framework-Projekte gilt. Das WCF-Webdienstreferenztool ruft Metadaten von einem Webdienst in der aktuellen Lösung, an einem Netzwerkspeicherort oder aus einer WSDL-Datei ab und generiert eine Quelldatei, die Windows Communication Foundation (WCF)-Clientproxycode enthält, den Ihre .NET-App für den Zugriff auf den Webdienst verwenden kann.

Von Bedeutung

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.

Voraussetzungen

• Visual Studio 2017, Version 15.5 oder höher

Die Screenshots in diesem Artikel stammen aus Visual Studio 2022.

So verwenden Sie die Erweiterung

Hinweis

Das WCF-Webdienstreferenztool gilt nur für C# .NET Core- und .NET Standard-Projekte, einschließlich ASP.NET Core Web Apps.

Mithilfe der Projektvorlage ASP.NET Core Web Application als Beispiel führt dieser Artikel Sie durch das Hinzufügen eines WCF-Dienstverweises zum Projekt.

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

   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 neuen WCF-Webdienstverweises angezeigt.

   

4. Wählen Sie einen Dienst aus.

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

   • Um in der aktuellen Lösung definiert nach Diensten zu suchen, klicken Sie auf die Schaltfläche " Entdecken ".
   • Um nach Diensten zu suchen, die an einer angegebenen Adresse gehostet werden, geben Sie eine Dienst-URL in das Feld "Adresse " ein, und klicken Sie auf die Schaltfläche " Gehe zu ".
   • Um eine WSDL-Datei auszuwählen, die die Metadateninformationen des Webdiensts enthält, klicken Sie auf die Schaltfläche " Durchsuchen ".

   b. Wählen Sie den Dienst aus der Liste der Suchergebnisse im Feld "Dienste " aus. Geben Sie bei Bedarf den Namespace für den generierten Code in das entsprechende Namespacetextfeld ein.

   Abschnitt c. Klicken Sie auf die Schaltfläche "Weiter ", um Datentypoptionen oder Clientoptionen anzugeben. Alternativ können Sie 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 wiederverwenden" in referenzierten Assemblys ist nützlich, wenn Datentypen, die für die Generierung von Dienstreferenzcode erforderlich sind, in einer der Referenzassemblys Ihres Projekts definiert sind. Es ist wichtig, diese bestehenden Datentypen wiederzuverwenden, um Typkonflikte während der Kompilierungszeit oder Laufzeitprobleme zu vermeiden.

   Es kann eine Verzögerung geben, während Typinformationen geladen werden, abhängig von der Anzahl der Projektabhängigkeiten und anderen Systemleistungsfaktoren. Die Schaltfläche " Fertig stellen " wird beim Laden deaktiviert, es sei denn, das Kontrollkästchen " Typen in referenzierten Assemblys wiederverwenden " ist deaktiviert.

6. Klicken Sie auf "Fertig stellen ", wenn Sie fertig sind.

Beim Anzeigen des Fortschritts zeigt das Tool Folgendes an:

• Lädt Metadaten aus dem WCF-Dienst herunter.
• Generiert den Dienstverweiscode in einer Datei namens reference.cs und fügt ihn ihrem Projekt unter dem Knoten "Verbundene Dienste " hinzu.
• Aktualisiert die Projektdatei (CSPROJ) mit NuGet-Paketverweise, die zum Kompilieren und Ausführen auf der Zielplattform erforderlich sind.

Nach Abschluss dieser Prozesse können Sie eine Instanz des generierten WCF-Clienttyps erstellen und die Dienstvorgänge aufrufen.

Siehe auch

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

Feedback & Fragen

Wenn Sie produktfeedback haben, melden Sie es in der Entwicklercommunity mit dem Tool "Problem melden ".

Versionshinweise

• In den Versionshinweisen finden Sie aktualisierte Versionsinformationen, einschließlich bekannter Probleme.