Het WCF-hulpprogramma voor webserviceverwijzingen gebruiken

In de loop der jaren hebben veel Visual Studio-ontwikkelaars genoten van de productiviteit die het hulpprogramma Serviceverwijzing toevoegen biedt wanneer hun .NET Framework-projecten toegang nodig hebben tot webservices.

Het WCF-webserviceverwijzingsprogramma is een service-extensie die is verbonden met Visual Studio waarmee u uw .NET 5+-, .NET Core- of ASP.NET Core-project kunt verbinden met een webservice. Het biedt een ervaring die vergelijkbaar is met de functionaliteit Servicereferentie toevoegen. Dit geldt alleen voor .NET Framework-projecten. Het WCF-webservicereferentieprogramma haalt metagegevens op uit een webservice in de huidige oplossing, op een netwerklocatie of uit een WSDL-bestand en genereert een bronbestand met WCF-clientproxycode (Windows Communication Foundation) die door uw .NET-app kan worden gebruikt voor toegang tot de webservice.

Belangrijk

U moet alleen verwijzen naar services van een vertrouwde bron. Als u verwijzingen van een niet-vertrouwde bron toevoegt, kan de beveiliging worden aangetast.

Vereisten

• Visual Studio 2017 versie 15.5 of hoger

De schermafbeeldingen in dit artikel zijn afkomstig van Visual Studio 2022.

De extensie gebruiken

Notitie

Het WCF-webservicereferentieprogramma is alleen van toepassing op C# .NET Core- en .NET Standard-projecten, waaronder ASP.NET Core-web-apps.

Met behulp van de ASP.NET Core Web Application-projectsjabloon als voorbeeld helpt dit artikel u bij het toevoegen van een WCF-servicereferentie aan het project.

1. Dubbelklik in Solution Explorer op het knooppunt Verbinding maken ed Services van het project. (Voor een .NET Core- of .NET Standard-project klikt u met de rechtermuisknop op het project en selecteert u Service toevoegen> Verbinding maken ed.)

   De pagina Verbinding maken ed Services wordt weergegeven zoals weergegeven in de volgende afbeelding:

   

2. Selecteer Op de pagina Verbinding maken ed Services de optie Servicereferentie toevoegen.

   De pagina Servicereferentie toevoegen wordt geopend.

3. Selecteer de WCF-webservice en kies vervolgens Volgende.

   Hiermee wordt de wizard Nieuwe WCF-webserviceservice toevoegen weergegeven.

   

4. Selecteer een service.

   a. Er zijn verschillende zoekopties voor services beschikbaar:

   • Als u wilt zoeken naar services die zijn gedefinieerd in de huidige oplossing, klikt u op de knop Ontdekken .
   • Als u wilt zoeken naar services die worden gehost op een opgegeven adres, voert u een service-URL in het vak Adres in en klikt u op de knop Start .
   • Als u een WSDL-bestand met de metagegevensgegevens van de webservice wilt selecteren, klikt u op de knop Bladeren .

   b. Selecteer de service in de lijst met zoekresultaten in het vak Services . Voer indien nodig de naamruimte in voor de gegenereerde code in het bijbehorende tekstvak Naamruimte .

   c. Klik op de knop Volgende om opties voor gegevenstypen of clientopties op te geven. U kunt ook op de knop Voltooien klikken om de standaardopties te gebruiken.

5. Op de pagina opties voor gegevenstypen kunt u de gegenereerde configuratie-instellingen voor servicereferenties verfijnen:

   

   Notitie

   Het selectievakje Typen opnieuw gebruiken in assembly's waarnaar wordt verwezen, is handig wanneer gegevenstypen die nodig zijn voor het genereren van servicereferentiecode, worden gedefinieerd in een van de assembly's waarnaar wordt verwezen in uw project. Het is belangrijk dat u deze bestaande gegevenstypen opnieuw gebruikt om problemen met het compileren van tijdsconflicten of runtimeproblemen te voorkomen.

   Er kan een vertraging optreden terwijl typegegevens worden geladen, afhankelijk van het aantal projectafhankelijkheden en andere systeemprestatiefactoren. De knop Voltooien is uitgeschakeld tijdens het laden, tenzij het selectievakje Opnieuw gebruiken in gekoppelde assembly's is uitgeschakeld.

6. Klik op Voltooien wanneer u klaar bent.

Tijdens het weergeven van de voortgang, het hulpprogramma:

• Hiermee downloadt u metagegevens van de WCF-service.
• Genereert de servicereferentiecode in een bestand met de naam reference.cs en voegt deze toe aan uw project onder het knooppunt Verbinding maken ed Services.
• Werkt het projectbestand (.csproj) bij met NuGet-pakketverwijzingen die vereist zijn om te compileren en uit te voeren op het doelplatform.

Wanneer deze processen zijn voltooid, kunt u een exemplaar van het gegenereerde WCF-clienttype maken en de servicebewerkingen aanroepen.

Zie ook

• Aan de slag met Windows Communication Foundation-toepassingen
• Windows Communication Foundation-services en WCF-gegevensservices in Visual Studio
• Door WCF ondersteunde functies op .NET Core

Feedback en vragen

Als u productfeedback hebt, meldt u het bij de Ontwikkelaarscommunity met behulp van het hulpprogramma Een probleem melden.

Opmerkingen bij de release

• Raadpleeg de releaseopmerkingen voor bijgewerkte release-informatie, inclusief bekende problemen.