Szablony programu Visual Studio WCF

Artykuł
03/02/2024

Szablony programu Visual Studio programu Windows Communication Foundation (WCF) to wstępnie zdefiniowane szablony projektów i elementów, których można używać w programie Visual Studio do szybkiego tworzenia usług WCF i otaczających aplikacji.

Korzystanie z szablonów WCF

Szablony programu Visual Studio WCF zapewniają podstawową strukturę klas na potrzeby tworzenia usług. W szczególności te szablony zawierają podstawowe definicje kontraktu usługi, kontraktu danych, implementacji usługi i konfiguracji. Za pomocą tych szablonów można utworzyć prostą usługę z minimalną interakcją z kodem, a także blok konstrukcyjny dla bardziej zaawansowanych usług.

Szablon projektu biblioteki usług WCF

Szablon projektu Biblioteka usług WCF jest dostępny w oknie dialogowym nowy projekt w obszarze Visual C#\WCF i Visual Basic\WCF.

Podczas tworzenia nowego projektu przy użyciu szablonu usługi WCF nowy projekt automatycznie zawiera następujące trzy pliki:

Plik kontraktu usługi (IService1.cs lub IService1.vb). Plik kontraktu usługi to interfejs z zastosowanymi atrybutami usługi WCF. Ten plik zawiera definicję prostej usługi, która pokazuje sposób definiowania usług oraz zawiera operacje oparte na parametrach i prosty przykład kontraktu danych. Jest to plik domyślny wyświetlany w edytorze kodu po utworzeniu projektu usługi WCF.
Plik implementacji usługi (Service1.cs lub Service1.vb). Plik implementacji usługi implementuje kontrakt zdefiniowany w pliku kontraktu usługi.
Plik konfiguracji aplikacji (App.config). Plik konfiguracji zawiera podstawowe elementy modelu usługi WCF z bezpiecznym powiązaniem HTTP. Zawiera również punkt końcowy usługi i umożliwia wymianę metadanych.

Uwaga

Program Visual Studio jest skonfigurowany do rozpoznawania pliku App.config jako pliku konfiguracji projektu podczas jego uruchamiania przy użyciu hosta usługi WCF (WcfSvcHost.exe), który jest konfiguracją domyślną. Jeśli hostujesz bibliotekę usługi w pliku wykonywalnym, musisz przenieść kod konfiguracji do pliku konfiguracji pliku wykonywalnego, ponieważ pliki konfiguracji bibliotek DLL są nieprawidłowe.

Szablon aplikacji usługi WCF

Szablon aplikacji usługi WCF jest dostępny w oknie dialogowym Nowy projekt w obszarze Visual C#\WCF i Visual Basic\WCF.

Podczas tworzenia nowego projektu przy użyciu szablonu usługi aplikacji internetowej WCF projekt zawiera następujące cztery pliki:

Plik hosta usługi (service1.svc).
Plik kontraktu usługi (IService1.cs lub IService1.vb).
Plik implementacji usługi (Service1.svc.cs lub Service1.svc.vb).
Plik konfiguracji sieci Web (Web.config).

Szablon automatycznie tworzy witrynę sieci Web (do wdrożenia w katalogu wirtualnym) i hostuje w niej usługę.

Szablon witryny sieci Web programu WCF

Szablon witryny sieci Web programu WCF jest dostępny w oknie dialogowym Nowy projekt w obszarze Visual C#\Web Site\WCF Service i Visual Basic\Web Site\WCF Service. Spowoduje to utworzenie tych samych plików co szablon aplikacji usługi WCF, ale organizuje je tak, jakby była to ASP.NET witrynie sieci Web. tworzone są foldery App_Code i App_Data.

Szablon elementu usługi WCF

Szablon elementu usługi WCF jest szablonem niestandardowym, który umożliwia szybkie dodawanie usług WCF do istniejących projektów programu Visual Studio.

Aby użyć tego szablonu, przejdź do okienka Eksplorator rozwiązań, kliknij prawym przyciskiem myszy nazwę projektu, wskaż polecenie Dodaj, a następnie kliknij polecenie Nowy element, aby uruchomić okno dialogowe Dodawanie nowego elementu.

Pliki interfejsu usługi i implementacji są umieszczane w głównym folderze projektu.

Szablon próbuje scalić sekcję konfiguracji nowej usługi z istniejącym plikiem konfiguracji, jeśli są one zgodne.

Plik hosta usługi (service1.svc) jest również tworzony, jeśli istniejący projekt jest projektem sieci Web.

Projekt usługi WF programu WCF i szablon elementu.

Te szablony tworzą usługi WCF hostujące usługę przepływu pracy, która jest przepływem pracy, do którego można uzyskać dostęp, takim jak usługa internetowa. Istnieją oddzielne szablony dla modeli programowania XAML lub imperatywnego. Za pomocą szablonów można utworzyć sekwencyjny lub stanowy przepływ pracy maszyny. Aby uzyskać więcej informacji na temat tego typu przepływu pracy, zobacz How to: Create a Workflow (Instrukcje: tworzenie przepływu pracy). Aby uzyskać więcej informacji na temat tworzenia projektów przepływu pracy, zobacz Tworzenie starszych projektów przepływu pracy.

Projektant programu Visual Studio jest bardziej dynamiczny, gdy przepływy pracy typu XOML są używane zamiast opartych na kodzie. Przepływ pracy XOML jest domyślnym typem przepływu pracy, który ma zostać utworzony.

Szablon biblioteki usługi syndykacji programu WCF

Ten szablon umożliwia uwidocznienie kanału informacyjnego w formacie RSS lub ATOM jako usługi WCF. Aby uzyskać więcej informacji, zobacz Syndication WCF.

Zmienianie adresu kanału informacyjnego

Szablon syndykacji używa przeglądarki internetowej podczas wykonywania. Po kliknięciu prawym przyciskiem myszy projektu w Eksplorator rozwiązań w programie Visual Studio wybierz pozycję Właściwości, a następnie wybierz kartę Debugowanie i zobaczysz domyślny adres szablonu. Przeglądarka próbuje otworzyć kanał informacyjny pod tym adresem.

Jeśli zmienisz adres kanału informacyjnego, musisz również zmienić adres na karcie Debugowanie . Jeśli tego nie zrobisz, przeglądarka podejmie próbę otwarcia kanału informacyjnego pod adresem domyślnym i zakończy się niepowodzeniem.

Szablon elementu usługi WCF z obsługą technologii AJAX

Ten szablon uwidacznia kontrolkę AJAX jako usługę WCF. Aby uzyskać więcej informacji na temat kontrolek AJAX, zobacz dokumentację kontrolki AJAX.

Szablon elementu usługi WCF z obsługą programu Silverlight

Ten szablon tworzy usługę sieci Web, która udostępnia dane klientowi programu Silverlight lub frontonowi. Szablon można dodać do witryny sieci Web lub projektu aplikacji internetowej w celu utworzenia usługi WCF, która zawiera kod usługi i konfigurację, która obsługuje komunikację z klientem silverlight. Następnie możesz użyć polecenia Dodaj odwołanie do usługi, aby dodać serwer proxy klienta usługi do klienta i wymienić dane między klientem programu Silverlight i usługą WCF z obsługą programu Silverlight.

Aby uzyskać dostęp do tego szablonu, kliknij prawym przyciskiem myszy witrynę sieci Web lub projekt aplikacji internetowej w Eksplorator rozwiązań, kliknij pozycję Dodaj nowy element, a następnie kliknij pozycję Usługa WCF z obsługą programu Silverlight.