Dela via

Använda verktyget WCF-webbtjänstreferensprovider

  • Artikel

Under årens lopp har många Visual Studio-utvecklare haft den produktivitet som verktyget Lägg till tjänstreferens gav när deras .NET Framework-projekt behövde komma åt webbtjänster.

WCF-webbtjänstreferensverktyget är ett Visual Studio-anslutet tjänsttillägg som gör att du kan ansluta ditt .NET 5+-, .NET Core- eller ASP.NET Core-projekt till en webbtjänst. Det ger en upplevelse som liknar funktionen Lägg till tjänstreferens , som endast gäller för .NET Framework-projekt. Referensverktyget för WCF-webbtjänsten hämtar metadata från en webbtjänst i den aktuella lösningen, på en nätverksplats eller från en WSDL-fil och genererar en källfil som innehåller WCF-klientproxykod (Windows Communication Foundation) som din .NET-app kan använda för att komma åt webbtjänsten.

Viktigt!

Du bör bara referera till tjänster från en betrodd källa. Att lägga till referenser från en ej betrodd källa kan äventyra säkerheten.

Förutsättningar

Skärmbilderna i den här artikeln är från Visual Studio 2022.

Så här använder du tillägget

Kommentar

Referensverktyget för WCF-webbtjänsten gäller endast för C# .NET Core- och .NET Standard-projekt, inklusive ASP.NET Core-webbappar.

Med projektmallen ASP.NET Core Web Application som exempel vägleder den här artikeln dig genom att lägga till en WCF-tjänstreferens till projektet.

  1. Dubbelklicka på noden Anslut ed Services i projektet i Solution Explorer. (Högerklicka på projektet för ett .NET Core- eller .NET Standard-projekt och välj Lägg till> Anslut ed Service.)

    Sidan Anslut ed Services visas enligt följande bild:

    Visual Studio Connected Services tab for .NET Core

  2. På sidan Anslut ed Services väljer du Lägg till tjänstreferens.

    Sidan Lägg till tjänstreferens öppnas.

  3. Välj WCF-webbtjänst och välj sedan Nästa.

    Då visas referensguiden lägg till ny WCF-webbtjänsttjänst.

    Visual Studio Service Endpoint tab for .NET Core

  4. Välj en tjänst.

    a. Det finns flera tillgängliga sökalternativ för tjänster:

    • Om du vill söka efter tjänster som definierats i den aktuella lösningen klickar du på knappen Identifiera .
    • Om du vill söka efter tjänster som finns på en angiven adress anger du en tjänst-URL i rutan Adress och klickar på knappen Gå .
    • Om du vill välja en WSDL-fil som innehåller information om webbtjänstens metadata klickar du på knappen Bläddra .

    b. Välj tjänsten i sökresultatlistan i rutan Tjänster . Om det behövs anger du namnområdet för den genererade koden i motsvarande textruta för namnområdet .

    c. Klicka på knappen Nästa för att ange alternativ för datatyp eller klientalternativ. Du kan också klicka på knappen Slutför för att använda standardalternativen.

  5. På sidan alternativ för datatyp kan du förfina konfigurationsinställningarna för den genererade tjänstreferensen:

    Visual Studio Data type options tab for .NET Core

    Kommentar

    Alternativet Återanvända typer i refererade sammansättningar är användbart när datatyper som behövs för generering av tjänstreferenskod definieras i en av projektets refererade sammansättningar. Det är viktigt att återanvända de befintliga datatyperna för att undvika kompilering av tidstypkonflikter eller körningsproblem.

    Det kan uppstå en fördröjning när typinformation läses in, beroende på antalet projektberoenden och andra systemprestandafaktorer. Knappen Slutför inaktiveras vid inläsning om inte kryssrutan Återanvända typer i refererade sammansättningar är avmarkerad.

  6. Klicka på Slutför när du är klar.

Verktyget visar förloppet:

  • Laddar ned metadata från WCF-tjänsten.
  • Genererar tjänstreferenskoden i en fil med namnet reference.cs och lägger till den i projektet under noden Anslut ed Services.
  • Uppdateringar projektfilen (.csproj) med NuGet-paketreferenser som krävs för att kompilera och köra på målplattformen.

Visual Studio Progress window

När dessa processer har slutförts kan du skapa en instans av den genererade WCF-klienttypen och anropa tjänståtgärderna.

Se även

Feedback och frågor

Om du har någon produktfeedback kan du rapportera den i Utvecklarcommunitynmed hjälp av verktyget Rapportera ett problem .

Viktig information