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 do značky stránky volat metody 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 ECMAScript (JavaScript), musíte zahrnout odkaz na službu na stránce ASP.NET a použít ScriptServiceAttribute atribut na definici třídy webové služby. Pokud do ovládacího prvku nebo ScriptManagerProxy na stránce ASP.NET zahrnete odkaz na webovou službuScriptManager, vytvoří se v prohlížeči instance javascriptových objektů.
Objekty proxy se použijí k následujícímu:
Provádění asynchronních požadavků v JavaScriptu na metody webové služby,
Inicializace instancí proxy serverových datových typů, zejména pro použití jako vstupních parametrů 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 deklarativně definovat přidáním elementu <asp:ServiceReference> do elementu <Services> uvnitř elementu <asp:ScriptManager> 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í, jestli je skript generování proxy serveru zahrnutý na stránce jako blok vloženého skriptu, nebo jestli je získán samostatným požadavkem.
Můžete také programově přidat ServiceReference objekt prostřednictvím ScriptManager.Services kolekce nebo ScriptManagerProxy.Services pomocí Add metody ServiceReferenceCollection třídy.
Konstruktory
| ServiceReference() |
Inicializuje novou instanci ServiceReference třídy. |
| ServiceReference(String) |
Inicializuje novou instanci ServiceReference třídy se zadanou cestou. |
Vlastnosti
| InlineScript |
Získá nebo nastaví hodnotu, která označuje, zda je skript generování proxy zahrnut na stránce jako blok vloženého skriptu nebo je získán samostatným požadavkem. |
| Path |
Získá nebo nastaví cestu odkazované webové služby. |
Metody
| Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
| GetProxyScript(ScriptManager, Control) |
Poskytuje skript proxy z odvozeného ServiceReference objektu, který lze přepsat jako přizpůsobení. |
| GetProxyUrl(ScriptManager, Control) |
Poskytuje adresu URL proxy serveru z odvozeného ServiceReference objektu, která se dá přepsat jako vlastní nastavení. |
| GetType() |
Získá aktuální Type instanci. (Zděděno od Object) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
| ToString() |
Vrátí řetězec, který představuje hodnotu Path vlastnosti nebo název typu. |
Platí pro
Viz také
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro