ServiceReference Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Zaregistruje webovou službu pro použití na webové stránce.
public ref class ServiceReferencepublic class ServiceReferencetype ServiceReference = classPublic Class ServiceReference- Dědičnost
-
ServiceReference
Příklady
Následující příklad ukazuje, jak přidat odkaz na webovou službu v kódu stránky pro volání metod webové služby ze skriptu.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<style type="text/css">
body { font: 11pt Trebuchet MS;
font-color: #000000;
padding-top: 72px;
text-align: center }
.text { font: 8pt Trebuchet MS }
</style>
<title>Calling Web Methods</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:ScriptManager runat="server" ID="scriptManagerId">
<Scripts>
<asp:ScriptReference Path="Scripts.js" />
</Scripts>
<Services>
<asp:ServiceReference Path="WebService.asmx" />
</Services>
</asp:ScriptManager>
<div>
<h2>Calling Web Methods</h2>
<table>
<tr align="left">
<td>Method that does not return a value:</td>
<td>
<!-- Getting no retun value from
the Web service. -->
<button id="Button1"
onclick="GetNoReturn()">No Return</button>
</td>
</tr>
<tr align="left">
<td>Method that returns a value:</td>
<td>
<!-- Getting a retun value from
the Web service. -->
<button id="Button2"
onclick="GetTime(); return false;">Server Time</button>
</td>
</tr>
<tr align="left">
<td>Method that takes parameters:</td>
<td>
<!-- Passing simple parameter types to
the Web service. -->
<button id="Button3"
onclick="Add(20, 30); return false;">Add</button>
</td>
</tr>
<tr align="left">
<td>Method that returns XML data:</td>
<td>
<!-- Get Xml. -->
<button id="Button4"
onclick="GetXmlDocument(); return false;">Get Xml</button>
</td>
</tr>
<tr align="left">
<td>Method that uses GET:</td>
<td>
<!-- Making a GET Web request. -->
<button id="Button5"
onclick="MakeGetRequest(); return false;">Make GET Request</button>
</td>
</tr>
</table>
</div>
</form>
<hr/>
<div>
<span id="ResultId"></span>
</div>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<style type="text/css">
body { font: 11pt Trebuchet MS;
font-color: #000000;
padding-top: 72px;
text-align: center }
.text { font: 8pt Trebuchet MS }
</style>
<title>Calling Web Methods</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:ScriptManager runat="server" ID="scriptManagerId">
<Scripts>
<asp:ScriptReference Path="Scripts.js" />
</Scripts>
<Services>
<asp:ServiceReference Path="WebService.asmx" />
</Services>
</asp:ScriptManager>
<div>
<h2>Calling Web Methods</h2>
<table>
<tr align="left">
<td>Method that does not return a value:</td>
<td>
<!-- Getting no retun value from
the Web service. -->
<button id="Button1"
onclick="GetNoReturn()">No Return</button>
</td>
</tr>
<tr align="left">
<td>Method that returns a value:</td>
<td>
<!-- Getting a retun value from
the Web service. -->
<button id="Button2"
onclick="GetTime(); return false;">Server Time</button>
</td>
</tr>
<tr align="left">
<td>Method that takes parameters:</td>
<td>
<!-- Passing simple parameter types to
the Web service. -->
<button id="Button3"
onclick="Add(20, 30); return false;">Add</button>
</td>
</tr>
<tr align="left">
<td>Method that returns XML data:</td>
<td>
<!-- Get Xml. -->
<button id="Button4"
onclick="GetXmlDocument(); return false;">Get Xml</button>
</td>
</tr>
<tr align="left">
<td>Method that uses GET:</td>
<td>
<!-- Making a GET Web request. -->
<button id="Button5"
onclick="MakeGetRequest(); return false;">Make GET Request</button>
</td>
</tr>
</table>
</div>
</form>
<hr/>
<div>
<span id="ResultId"></span>
</div>
</body>
</html>
Poznámky
Chcete-li volat metody webové služby z ECMAScriptu (JavaScript), musíte na stránce ASP.NET zahrnout odkaz na službu a použít ScriptServiceAttribute atribut na definici třídy webové služby. Pokud do stránky ASP.NET zahrnete odkaz na webovou službu ScriptManager nebo ScriptManagerProxy ovládací prvek, vytvoří se v prohlížeči instance javascriptových objektů.
Objekty proxy se použijí k provedení následujících kroků:
Provádění asynchronních požadavků v JavaScriptu na metody webové služby,
Inicializuje instance proxy serverů datových typů, zejména pro použití jako vstupní parametry pro vyvolání webových metod.
Poznámka:
Ovládací ServiceReference prvek lze použít pouze pro služby ve stejné doméně.
Umístění webové služby můžete definovat deklarativní přidáním <asp:ServiceReference> elementu do elementu <Services> uvnitř <asp:ScriptManager> prvku na stránce a následným nastavením jeho Path atributu, jak je znázorněno v následujícím příkladu.
<asp:ScriptManager runat="server" ID="scriptManager">
<Services>
<asp:ServiceReference Path="~/WebServices/SimpleWebService.asmx" />
</Services>
</asp:ScriptManager>
Vlastnost můžete použít InlineScript k označení, zda je skript pro generování proxy serveru součástí stránky jako vložený blok skriptu nebo je získán samostatným požadavkem.
Objekt můžete také přidat ServiceReference prostřednictvím kódu programu prostřednictvím ScriptManager.Services nebo ScriptManagerProxy.Services kolekce pomocí Add metody ServiceReferenceCollection třídy.
Konstruktory
| Name | Description |
|---|---|
| ServiceReference() |
Inicializuje novou instanci ServiceReference třídy. |
| ServiceReference(String) |
Inicializuje novou instanci ServiceReference třídy se zadanou cestou. |
Vlastnosti
| Name | Description |
|---|---|
| InlineScript |
Získá nebo nastaví hodnotu, která označuje, zda je skript pro generování proxy serveru součástí stránky jako vložený blok skriptu nebo je získán samostatným požadavkem. |
| Path |
Získá nebo nastaví cestu odkazované webové služby. |
Metody
| Name | Description |
|---|---|
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetProxyScript(ScriptManager, Control) |
Poskytuje proxy skript z odvozeného ServiceReference objektu, který lze přepsat jako vlastní nastavení. |
| GetProxyUrl(ScriptManager, Control) |
Poskytuje adresu URL proxy serveru z odvozeného ServiceReference objektu lze přepsat jako vlastní nastavení. |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| ToString() |
Vrátí řetězec, který představuje hodnotu Path vlastnosti nebo název typu. |
