Sdílet prostřednictvím

Vytváření ukázek Windows Communication Foundation

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é z ukázek WCF se ujistěte, že jste provedli instalační proceduruOne-Time 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 na příkazovém řádku. Soubory klientského programu jsou sestaveny do souboru client\bin a soubory programu služby jsou sestaveny do služby\bin. Pokud službu hostuje 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:

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

Sestavení ukázky 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, aby poskytly oprávnění k úpravám účtu, pod kterým běžíte. Jinak některé události po dokončení 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é to 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. Podívejte se na ukázku vlastního zabezpečeného koncového bodu metadat, která ukazuje, jak zabezpečit koncový bod 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 klientský kód 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 ručně zadat dříve nakonfigurované přihlašovací údaje. Některé ukázky používají konkrétní možnosti Svcutil.exe k ovlivnění vygenerovaného kódu. Tyto možnosti jsou uvedené 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 samohostovaného typu, 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 samostatně hostované služby.

    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 samohostovaná, 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é

  • Last updated on