WCF Visual Studio-sablonok

Cikk
2023. 04. 08.

A Windows Communication Foundation (WCF) Visual Studio-sablonok előre definiált projekt- és elemsablonok, amelyeket a Visual Studióban használhat a WCF-szolgáltatások és a környező alkalmazások gyors létrehozásához.

A WCF-sablonok használata

A WCF Visual Studio-sablonok alapszintű osztálystruktúrát biztosítanak a szolgáltatásfejlesztéshez. Ezek a sablonok a szolgáltatásszerződés, az adatszerződés, a szolgáltatás implementációja és a konfiguráció alapvető definícióit biztosítják. Ezekkel a sablonokkal létrehozhat egy egyszerű szolgáltatást minimális kódhasználattal, valamint építőelemként a fejlettebb szolgáltatásokhoz.

WCF szolgáltatástár projektsablonja

A WCF szolgáltatástár projektsablonja a Visual C#\WCF és a Visual Basic\WCF új projekt párbeszédpaneljén érhető el.

Amikor új projektet hoz létre a WCF szolgáltatássablon használatával, az új projekt automatikusan a következő három fájlt tartalmazza:

Szolgáltatási szerződés fájlja (IService1.cs vagy IService1.vb). A szolgáltatási szerződés fájlja egy olyan felület, amely WCF-szolgáltatásattribútumokat alkalmaz. Ez a fájl egy egyszerű szolgáltatás definícióját tartalmazza, amely bemutatja, hogyan definiálhatja a szolgáltatásokat, és tartalmaz paraméteralapú műveleteket és egy egyszerű adatszerződés-mintát. Ez az alapértelmezett fájl, amely egy WCF-szolgáltatásprojekt létrehozása után jelenik meg a kódszerkesztőben.
Szolgáltatás-implementációs fájl (Service1.cs vagy Service1.vb). A szolgáltatásvégrehajtási fájl implementálja a szolgáltatási szerződés fájljában meghatározott szerződést.
Alkalmazáskonfigurációs fájl (App.config). A konfigurációs fájl biztonságos HTTP-kötéssel biztosítja a WCF-szolgáltatásmodell alapvető elemeit. Emellett tartalmaz egy végpontot a szolgáltatáshoz, és lehetővé teszi a metaadatok cseréjét.

Megjegyzés

A Visual Studio úgy van konfigurálva, hogy felismerje az App.config fájlt a projekt konfigurációs fájljaként, amikor az a WCF szolgáltatásgazda (WcfSvcHost.exe) használatával fut, ez az alapértelmezett konfiguráció. Ha egy végrehajtható fájlban üzemelteti a szolgáltatástárat, át kell helyeznie a konfigurációs kódot a végrehajtható konfigurációs fájlba, mivel a DLL-ekhez tartozó konfigurációs fájlok érvénytelenek.

WCF szolgáltatásalkalmazás-sablon

A WCF szolgáltatásalkalmazás-sablon a Visual C#\WCF és a Visual Basic\WCF új projekt párbeszédpaneljén érhető el.

Amikor új projektet hoz létre a WCF Web Application Service sablonnal, a projekt a következő négy fájlt tartalmazza:

Szolgáltatásgazdafájl (service1.svc).
Szolgáltatási szerződés fájlja (IService1.cs vagy IService1.vb).
Szolgáltatás-implementációs fájl (Service1.svc.cs vagy Service1.svc.vb).
Webkonfigurációs fájl (Web.config).

A sablon automatikusan létrehoz egy webhelyet (virtuális címtárban üzembe helyezendő), és egy szolgáltatást üzemeltet benne.

WCF-webhelysablon

A WCF-webhelysablon a Visual C#\Web Site\WCF Szolgáltatás és a Visual Basic\Web Site\WCF szolgáltatás Új projekt párbeszédpaneljén érhető el. Ez ugyanazokat a fájlokat hozza létre, mint a WCF szolgáltatásalkalmazás-sablon, de úgy rendszerezi, mintha ASP.NET webhely lenne. App_Code és App_Data mappák jönnek létre.

WCF szolgáltatáselem-sablon

A WCF szolgáltatáselem-sablon egy egyéni sablon, amely gyors módot kínál a WCF-szolgáltatások meglévő Visual Studio-projektekhez való hozzáadására.

A sablon használatához nyissa meg a Megoldáskezelő panelt, kattintson a jobb gombbal a projekt nevére, mutasson a Hozzáadás pontra, majd az Új elem elemre kattintva indítsa el az Új elem hozzáadása párbeszédpanelt.

A szolgáltatási felület és a megvalósítási fájlok a gyökérprojekt mappájába kerülnek.

A sablon megpróbálja egyesíteni az új szolgáltatás konfigurációs szakaszát a meglévő konfigurációs fájllal, ha kompatibilis típusok.

A szolgáltatás gazdagépfájlja (service1.svc) akkor is létrejön, ha a meglévő projekt egy webes projekt.

WCF WF szolgáltatásprojekt és elemsablon.

Ezek a sablonok olyan WCF-szolgáltatásokat hoznak létre, amelyek munkafolyamat-szolgáltatást üzemeltetnek, amely egy webszolgáltatásként elérhető munkafolyamat. Az XAML- vagy imperatív programozási modellekhez külön sablonok léteznek. A sablonok használatával szekvenciális vagy állapotgép-munkafolyamatot hozhat létre. Az ilyen típusú munkafolyamatokról további információt a Munkafolyamat létrehozása című témakörben talál. A munkafolyamat-projektek létrehozásáról további információt az Örökölt munkafolyamat-projektek létrehozása című témakörben talál.

A Visual Studio designer rugalmasabb, ha XOML típusú munkafolyamatokat használ a kódalapúak helyett. A létrehozandó alapértelmezett munkafolyamattípus az XOML-munkafolyamat.

WCF Syndication Service Library-sablon

Ez a sablon lehetővé teszi, hogy a hírcsatornát RSS vagy ATOM formátumban tegye közzé WCF szolgáltatásként. További információ: WCF Syndication.

A hírcsatorna címének módosítása

A szindikálási sablon egy webböngészőt használ a végrehajtás során. Amikor a jobb gombbal a projektre kattint a Megoldáskezelő a Visual Studióban, válassza a Tulajdonságok lehetőséget, majd válassza a Hibakeresés lapot, és láthatja a sablon alapértelmezett címét. A böngésző megkísérli megnyitni a hírcsatornát ezen a címen.

Ha módosítja a hírcsatorna címét, a Hibakeresés lapon is módosítania kell a címet. Ha ezt nem teszi meg, a böngésző megkísérli megnyitni a hírcsatornát az alapértelmezett címen, és sikertelen lesz.

AJAX-kompatibilis WCF-szolgáltatáselem-sablon

Ez a sablon egy AJAX-vezérlőt tesz elérhetővé WCF-szolgáltatásként. Az AJAX-vezérlőkkel kapcsolatos további információkért tekintse meg az AJAX-vezérlők dokumentációját.

Silverlight-kompatibilis WCF szolgáltatáselem-sablon

Ez a sablon létrehoz egy webszolgáltatást, amely adatokat biztosít a Silverlight-ügyfélnek vagy az előtérnek. A sablon hozzáadható egy webhelyhez vagy egy webalkalmazás-projekthez egy WCF-szolgáltatás létrehozásához, amely tartalmazza a Silverlight-ügyféllel való kommunikációt támogató szolgáltatáskódot és konfigurációt. Ezután a Szolgáltatáshivatkozás hozzáadása funkcióval hozzáadhatja a szolgáltatás ügyfélproxyját az ügyfélhez, és adatokat cserélhet a Silverlight-ügyfél és a Silverlight-kompatibilis WCF szolgáltatás között.

A sablon eléréséhez kattintson a jobb gombbal egy webhelyre vagy egy webalkalmazás-projektre Megoldáskezelő, kattintson az Új elem hozzáadása parancsra, majd a Silverlight-kompatibilis WCF-szolgáltatásra.