Ukázky vytváření Windows Communication Foundation

  • Článek

Ukázky Windows Communication Foundation (WCF) je možné sestavit pomocí integrovaného vývojového prostředí sady Visual Studio nebo příkazu msbuild z příkazového řádku. Oba postupy jsou popsány v tomto článku.

Poznámka:

Před sestavením nebo spuštěním některé ukázky WCF se ujistěte, že jste provedli jednorázovou instalační proceduru pro ukázky Windows Communication Foundation.

Sestavení ukázky pomocí příkazového řádku

  1. Otevřete Příkazový řádek pro vývojáře pro Visual Studio a přejděte do podadresáře specifického pro jazyk v umístění adresáře, kam jste ukázku nainstalovali.

  2. Zadejte msbuild příkazový řádek. Soubory klientského programu jsou sestaveny do souboru client\bin a soubory programu služby jsou sestaveny do služby\bin. Pokud je služba hostovaná službou Internetová informační služba (IIS), soubory programu služby se také zkopírují do adresáře servicemodelsamples a jeho podadresáře \bin.

Poznámka:

Musíte nastavit seznamy ACL na %systemdrive%\inetpub\wwwroot tak, aby udělily oprávnění k úpravě účtu, pod kterým běžíte. Jinak některé události po sestavení selžou. Případně můžete seznamy ACL ponechat tak, jak jsou, a spustit příkazový řádek sady SDK jako správce.

K vytvoření vzorku pomocí sady Visual Studio

  1. V nabídce Soubor v sadě Visual Studio vyberte Otevřít>projekt nebo řešení. Přejděte do podadresáře specifického pro jazyk v adresáři, ve kterém jste ukázku nainstalovali, a poklikáním na ikonu souboru .sln otevřete řešení v sadě Visual Studio.

  2. V nabídce Sestavení vyberte Znovu sestavit řešení.

    Soubory klientského programu jsou sestaveny do souboru client\bin a soubory programu služby jsou sestaveny do služby\bin. Pokud je služba hostovaná ve službě IIS, soubory programu služby se také zkopírují do adresáře servicemodelsamples a jeho podadresáře \bin .

Poznámka:

Musíte nastavit seznamy ACL na %systemdrive%\inetpub\wwwroot tak, aby udělily oprávnění k úpravě účtu, pod kterým běžíte. Jinak některé události po sestavení selžou. Případně můžete seznamy ACL ponechat tak, jak jsou, a spustit příkazový řádek sady SDK nebo Sadu Visual Studio jako správce. Některé akce sady Visual Studio (například připojení ladicího programu k pracovnímu procesu ASP.NET) také vyžadují oprávnění správce.

Nastavení dávkových souborů a skriptů

Setup.exe a Cleanup.exe dávkové soubory a skripty by se měly spouštět z příkazového řádku pro vývojáře pro Visual Studio. Několik nastavení a vyčištění souborů provádí úlohy, které vyžadují oprávnění správce a měly by být spuštěny s oprávněními správce.

Důležité informace o zabezpečení koncových bodů metadat

Aby se zabránilo neúmyslnému zpřístupnění potenciálně citlivých metadat služby, výchozí konfigurace pro služby WCF (Windows Communication Foundation) zakáže publikování metadat. Toto chování je ve výchozím nastavení zabezpečené, ale také znamená, že nemůžete použít nástroj pro import metadat (například Svcutil.exe) k vygenerování kódu klienta potřebného k volání služby, pokud není explicitně povolené chování publikování metadat služby v konfiguraci. Aby se experimentování s ukázkami usnadnilo, téměř všechny ukázky zveřejňují nezabezpečený koncový bod publikování metadat. Tyto koncové body jsou potenciálně dostupné anonymním neověřeným příjemcům a před nasazením těchto koncových bodů je potřeba zajistit, aby byla veřejně zpřístupněna metadata služby. Další informace o publikování metadat služby naleznete v ukázce chování publikování metadat. Ukázku zabezpečení koncového bodu metadat najdete v ukázce zabezpečení koncového bodu metadat.

Zpracování výjimek

Obecně platí, že tyto ukázky nezahrnují zpracování výjimek, aby byl kód zaměřený na předmět vzorku. Další informace o zpracování výjimek naleznete v ukázce Očekávaných výjimek.

Opětovné generování klientů a konfigurace pomocí nástroje Svcutil

Pomocí nástroje ServiceModel Metadata Utility (Svcutil.exe) můžete znovu vygenerovat kód klienta a konfiguraci pro většinu ukázek. Některé ukázky vyžadují ručně upravenou konfiguraci. Pokud například použijete Svcutil.exe k opětovnému vygenerování konfigurace pro ukázku, která používá přihlašovací údaje klientského certifikátu, musíte přihlašovací údaje dříve nakonfigurované ručně zadat. Některé ukázky používají konkrétní možnosti Svcutil.exe, aby ovlivnily vygenerovaný kód, tyto možnosti jsou uvedeny v konkrétních ukázkových tématech.

Opětovné vygenerování klienta a konfiguračních souborů

  1. Otevřete příkazový řádek sady SDK a přejděte do podadresáře specifického pro jazyk v umístění adresáře, kam jste ukázku nainstalovali.

  2. Pokud je služba typu hostovaná webem, použijte následující příkaz.

    svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost/servicemodelsamples/service.svc/mex /out:generatedClient.cs

    Pokud je služba místním hostitelem, zadejte následující příkaz.

    svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost:8000/servicemodelsamples/service.svc/mex /out:generatedClient.cs

    Nahraďte http://localhost:8000/ServiceModelSamples/service.svc/mex adresou koncového bodu mex služby v místním prostředí.

    K vygenerování klienta v jazyce Visual Basic použijte následující příkaz.

    svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost/servicemodelsamples/service.svc/mex /l:vb /out:generatedClient.vb

    Pokud je služba typu v místním prostředí, použijte následující příkaz.

    svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost:8000/servicemodelsamples/service.svc/mex /l:vb /out:generatedClient.vb

    Poznámka:

    Pokud chcete přeskočit generování konfigurace klienta, přidejte možnost /noConfig .

Viz také