Webové reference v sadě Visual Studio

Článek
10/15/2014

Sada Visual Studio obsahuje webové odkazy pro zjednodušení vývoje klientských aplikací webové služby XML. Webové odkazy se liší od tradičních odkazů a komponent; namísto odkazování na komponentu nebo knihovnu tříd nainstalovanou v místním počítači, poskytuje webový odkaz přístup k prostředku, který je k dispozici pomocí protokolu internetu, jako je například protokol SOAP nebo protokol HTTP.

V praxi je webový odkaz vygenerován proxy třídou, která lokálně představuje funkčnost vystavenou webovou službou XML. Proxy třída definuje metody, které představují skutečné metody vystavené webovou službou XML. Když aplikace vytvoří instanci proxy třídy, může volat metody webové služby XML stejně, jako kdyby webová služba XML byla lokálně dostupná komponenta. Pokyny k vytvoření webového odkazu naleznete v tématu Postupy: Přidání a odebrání webových referencí.

Poznámka

Aby webová služba XML nacházející se za bránou firewall byla dostupná webovému prohlížeči, je nutné explicitně zadat adresu a port proxy serveru vaší sítě, když v sadě Visual Studio vytváříte webový odkaz.

Programovací jazyk vygenerované proxy třídy bude stejný jako programovací jazyk webové služby, kterou proxy třída představuje. Pokud vytvoříte proxy třídu nezávisle na sadě Visual Studio (například pomocí nástroje rozhraní .NET Framework), programovací jazyk závisí na použitém nástroji. Použijete-li například nástroj WSDL.exe, můžete v příkazovém řádku určit buď programovací jazyk C# nebo jazyk Visual Basic. Pokud použijete nástroj SProxy.exe, bude programovací jazyk Visual C++. Další informace naleznete v tématu Web Services Description Language Tool (Wsdl.exe).

V době návrhu proxy třída umožňuje používat dokončování příkazů pro metody webové služby XML. V době běhu je volání metody proxy objektu zpracováno a zakódováno jako zpráva žádosti protokolu SOAP. Pokud webová služba XML nepodporuje protokol SOAP, použije proxy třída metody GET a POST protokolu HTTP. Zpráva je poté odeslána ke zpracování cílové webové službě. Pokud popis služby definuje zprávu odpovědi, proxy objekt tuto zprávu zpracuje a vrátí odpověď vaší aplikaci.

Správa webových odkazů

Webové odkazy můžete přejmenovat nebo změnit, popř. aktualizovat, pokud byla odkazovaná webová služba změněna. Další informace naleznete v tématech Postup: Přejmenování webového odkazu na projekt a Postup: Aktualizace webového odkazu na projekt.

Vlastnost chování URL

Každý webový odkaz ve vašem projektu pracuje s proxy třídou, která je použita pro přístup k webové službě. Můžete použít vlastnost URL webového odkazu, abyste určili adresu URL webové služby XML. V technologii ASP.NET verze 1.1 webový odkaz může použít buď statickou nebo dynamickou adresu URL. Webový odkaz technologie ASP.NET 2.0 a novější obdrží adresu URL dynamicky. Další informace naleznete v tématu Locating Web Services.

Pokud v sadě Visual Studio vytvoříte webový odkaz pomocí dialogového okna Přidat webový odkaz, tato vlastnost je ve výchozím nastavení nastavena na adresu URL vybrané webové služby XML, což je statická adresa URL. Ponecháte-li chování adresy URL nastavené na výchozí statickou hodnotu, proxy třída nastaví vlastnost URL pomocí pevně zakódované adresy URL při vytvoření instance třídy.

Pokud nastavíte chování adresy URL webového odkazu na dynamické, aplikace obdrží adresu URL z prvku appSettings konfiguračního souboru aplikace za běhu.