Megosztás a következőn keresztül:

A WCF webszolgáltatás-referenciaszolgáltató eszköz használata

Az évek során számos Visual Studio-fejlesztő élvezte az Add Service Reference eszköz által biztosított hatékonyságot, amikor a .NET-keretrendszer-projektjeiknek szükségük volt a webszolgáltatások elérésére.

A WCF webszolgáltatás-referenciaeszköz egy Visual Studio-hoz csatlakoztatott szolgáltatásbővítmény, amely lehetővé teszi a .NET 5+, .NET Core vagy ASP.NET Core-projekt webszolgáltatáshoz való csatlakoztatását. Az Add Service Reference funkcióhoz hasonló élményt nyújt, amely csak .NET-keretrendszer-projektekhez használható. A WCF webszolgáltatás-referenciaeszköz lekéri a metaadatokat egy webszolgáltatásból az aktuális megoldásban, hálózati helyen vagy WSDL-fájlból, és létrehoz egy forrásfájlt, amely tartalmazza a Windows Communication Foundation (WCF) ügyfélproxy-kódját, amelyet a .NET-alkalmazás használhat a webszolgáltatás eléréséhez.

Fontos

Csak megbízható forrásból származó szolgáltatásokra kell hivatkoznia. A nem megbízható forrásból származó hivatkozások hozzáadása veszélyeztetheti a biztonságot.

Előfeltételek

A cikkben szereplő képernyőképek a Visual Studio 2022-ből származnak.

A bővítmény használata

Megjegyzés:

A WCF webszolgáltatás-referenciaeszköze csak C# .NET Core- és .NET Standard-projektekre alkalmazható, beleértve a ASP.NET Core-webalkalmazásokat is.

A ASP.NET Core Web Application-projektsablon példaként való használatával ez a cikk végigvezeti egy WCF-szolgáltatáshivatkozás projekthez való hozzáadásán.

  1. A Megoldáskezelőben kattintson duplán a projekt Csatlakoztatott szolgáltatások csomópontjára. (.NET Core- vagy .NET Standard-projekt esetén kattintson a jobb gombbal a projektre, és válassza a Hozzáadás lehetőséget>.Csatlakoztatott szolgáltatás.)

    A Csatlakoztatott szolgáltatások lap az alábbi képen látható módon jelenik meg:

    Visual Studio Connected Services fül a .NET Core-hoz

  2. A Csatlakoztatott szolgáltatások lapon válassza a Szolgáltatáshivatkozás hozzáadása lehetőséget.

    Megnyílik a Szolgáltatás hozzáadása referencialap .

  3. Válassza a WCF webszolgáltatást, majd a Tovább gombot.

    Ekkor megjelenik az Új WCF Web Service-szolgáltatás referenciájának hozzáadása varázsló.

    Visual Studio Service Endpoint fül a .NET Core számára

  4. Válasszon ki egy szolgáltatást.

    a). Számos szolgáltatáskeresési lehetőség érhető el:

    • Az aktuális megoldásban definiált szolgáltatások kereséséhez kattintson a Felfedezés gombra.
    • Ha egy megadott címen üzemeltetett szolgáltatásokat szeretne keresni, írja be a szolgáltatás URL-címét a Cím mezőbe, és kattintson az Ugrás gombra.
    • A webszolgáltatás metaadatait tartalmazó WSDL-fájl kiválasztásához kattintson a Tallózás gombra.

    b. Válassza ki a szolgáltatást a Szolgáltatások mezőben található keresési eredmények listájából. Szükség esetén írja be a létrehozott kód névterét a megfelelő Névtér szövegmezőbe.

    c) Kattintson a Tovább gombra az adattípus-beállítások vagy az ügyfélbeállítások megadásához. Másik lehetőségként kattintson a Befejezés gombra az alapértelmezett beállítások használatához.

  5. Az adattípus beállításainak lapja lehetővé teszi a létrehozott szolgáltatáshivatkozás konfigurációs beállításainak pontosítását:

    Visual Studio adattípus beállítások lap a .NET Core-hoz

    Megjegyzés:

    A hivatkozott szerelvények újrafelhasználási típusai jelölőnégyzet akkor hasznos, ha a szolgáltatáshivatkozási kód generálásához szükséges adattípusok a projekt hivatkozott szerelvények egyikében vannak definiálva. Fontos, hogy újrahasználja ezeket a meglévő adattípusokat a fordítási idejű típusütközések és a futásidejű problémák elkerülése érdekében.

    Előfordulhat, hogy a típusadatok betöltése késéssel jár a projektfüggőségek számától és más rendszerteljesítmény-tényezőktől függően. A Befejezés gomb betöltés közben le van tiltva, kivéve, ha a hivatkozott szerelvények újrafelhasználási típusai jelölőnégyzet nincs bejelölve.

  6. Ha elkészült, kattintson a Befejezés gombra.

A folyamat megjelenítése közben az eszköz:

  • Metaadatokat tölt le a WCF szolgáltatásból.
  • Létrehozza a szolgáltatáshivatkozási kódot egy reference.cs nevű fájlban, és hozzáadja a projekthez a Csatlakoztatott szolgáltatások csomópont alatt.
  • Frissíti a projektfájlt (.csproj) a célplatformon való fordításhoz és futtatáshoz szükséges NuGet-csomaghivatkozásokkal.

Visual Studio Folyamat ablak

Ha ezek a folyamatok befejeződnek, létrehozhatja a létrehozott WCF-ügyféltípus egy példányát, és meghívhatja a szolgáltatásműveleteket.

Lásd még

Visszajelzés és kérdések

Ha bármilyen termékvisszajelzéssel rendelkezik, jelentse azt a fejlesztői közösségnél a Jelentés egy probléma eszköz használatával.

Kibocsátási megjegyzések