Ukázky vytváření Windows Communication Foundation

ukázky Windows Communication Foundation (WCF) lze sestavit pomocí Visual Studio integrovaného vývojového prostředí (WCF) nebo příkazu msbuild z příkazového řádku. V tomto článku jsou popsány oba postupy.

Poznámka

před vytvořením nebo spuštěním kterékoli z ukázek služby WCF se ujistěte, že jste provedli jednorázovou proceduru nastavení pro Windows Communication Foundation ukázky.

Postup sestavení ukázky pomocí příkazového řádku

  1. otevřete Developer Command Prompt pro Visual Studio a přejděte do podadresáře pro konkrétní jazyk v umístění adresáře, kam jste si nainstalovali ukázku.

  2. Do příkazového řádku zadejte msbuild . Soubory klientských programů jsou sestaveny tak, aby client\bin a programové soubory služby jsou sestaveny tak, aby service\bin. pokud je služba hostovaná službou Internetová informační služba (IIS), soubory programu služby se zkopírují i do adresáře servicemodelsamples a jeho podadresáře \bin .

Poznámka

Je nutné nastavit seznamy ACL pro %systemdrive%\Inetpub\Wwwroot tak, aby udělily oprávnění k úpravám účtu, pod kterým je spuštěný. 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 Visual Studio vyberte otevřítProject/Solution. V adresáři, ve kterém jste nainstalovali ukázku, přejděte do podadresáře pro konkrétní jazyk a dvakrát klikněte na ikonu souboru. sln a otevřete řešení v Visual Studio.

  2. V nabídce sestavení vyberte znovu Sestavit řešení.

    Soubory klientských programů jsou sestaveny tak, aby client\bin a programové soubory služby jsou sestaveny tak, aby service\bin. Pokud je služba hostovaná ve službě IIS, soubory programu služby se zkopírují i do adresáře ServiceModelSamples a jeho podadresáře \Bin .

Poznámka

Je nutné nastavit seznamy ACL pro%systemdrive%\Inetpub\Wwwroot tak, aby udělily oprávnění k úpravám účtu, pod kterým je spuštěný. Jinak některé události po sestavení selžou. případně můžete seznamy acl ponechat tak, jak jsou, a spusťte příkazový řádek sady SDK nebo Visual Studio jako správce. některé akce Visual Studio (například připojení ladicího programu k pracovnímu procesu ASP.NET) vyžadují také oprávnění správce.

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

Setup.exe a Cleanup.exe dávkové soubory a skripty by měly být spouštěny z Developer Command Prompt 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 spouštěny s oprávněními správce.

Důležité informace o zabezpečení pro koncové body metadat

aby nedocházelo k neúmyslnému zveřejnění potenciálně citlivých metadat služby, služba výchozí konfigurace služby Windows Communication Foundation (WCF) zakáže publikování metadat. Ve výchozím nastavení je toto chování 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, který je vyžadován pro volání služby, pokud není chování publikování metadat služby explicitně povoleno v konfiguraci. Téměř všechny ukázky vystavují nezabezpečený koncový bod publikování metadat, aby bylo experimentování s ukázkami snazší. Tyto koncové body jsou možná dostupné anonymním neověřeným příjemcům a před nasazením těchto koncových bodů je nutné zajistit, aby bylo zajištěno, že bude jejich veřejněné zveřejnění metadat služby vhodné. Další informace o publikování metadat služby najdete v ukázce chování publikování metadat . Ukázku zabezpečení koncového bodu metadat najdete v ukázce pro Vlastní zabezpečený koncový bod metadat .

Zpracování výjimek

Obecně řečeno tyto ukázky nezahrnují zpracování výjimek, aby se kód zaměřil na předmět ukázky. 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í Svcutil

K opětovnému vygenerování kódu a konfigurace klienta pro většinu ukázek můžete použít nástroj pro dodávání metadat (Svcutil.exe) . Některé ukázky vyžadují ruční úpravu konfigurace. 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 přihlašovací údaje, které jste nakonfigurovali dříve. Některé ukázky používají konkrétní možnosti Svcutil.exe pro ovlivnění vygenerovaného kódu, tyto možnosti jsou uvedeny v konkrétních ukázkových tématech.

Obnovení klientského a konfiguračního souboru

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

  2. Pokud je služba typu na webu, 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ě hostovaná, 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 samoobslužné služby.

    k vygenerování klienta v typu 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 tato služba samoobslužným typem, 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é