ServiceReference Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Registra un servizio Web da utilizzare in una pagina Web.
public ref class ServiceReferencepublic class ServiceReferencetype ServiceReference = classPublic Class ServiceReference- Ereditarietà
-
ServiceReference
Esempio
Nell'esempio seguente viene illustrato come aggiungere un riferimento a un servizio Web nel markup di pagina per chiamare i metodi del servizio Web dallo script.
<%@ 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>
Commenti
Per chiamare i metodi del servizio Web da ECMAScript (JavaScript), è necessario includere un riferimento al servizio nella pagina ASP.NET e applicare l'attributo ScriptServiceAttribute alla definizione della classe del servizio Web. Se si include un riferimento al servizio a un servizio Web nel controllo o ScriptManagerProxy all'interno ScriptManager della pagina ASP.NET, nel browser verrà creata un'istanza degli oggetti JavaScript.
Gli oggetti proxy verranno usati per eseguire le operazioni seguenti:
Effettuare richieste asincrone in JavaScript ai metodi del servizio Web,
Inizializzare istanze di proxy dei tipi di dati del server, in particolare per l'uso come parametri di input per richiamare i metodi Web.
Nota
Il ServiceReference controllo può essere usato solo per i servizi nello stesso dominio.
È possibile definire la posizione del servizio Web in modo dichiarativo aggiungendo un <asp:ServiceReference> elemento all'elemento all'interno dell'elemento <Services><asp:ScriptManager> nella pagina e quindi impostandone Path l'attributo, come illustrato nell'esempio seguente.
<asp:ScriptManager runat="server" ID="scriptManager">
<Services>
<asp:ServiceReference Path="~/WebServices/SimpleWebService.asmx" />
</Services>
</asp:ScriptManager>
È possibile usare la InlineScript proprietà per indicare se lo script di generazione del proxy è incluso nella pagina come blocco di script inline o se viene ottenuto da una richiesta separata.
È anche possibile aggiungere un ServiceReference oggetto a livello di codice tramite l'insieme ScriptManager.Services o ScriptManagerProxy.Services usando il Add metodo della ServiceReferenceCollection classe .
Costruttori
| ServiceReference() |
Inizializza una nuova istanza della classe ServiceReference. |
| ServiceReference(String) |
Inizializza una nuova istanza della classe ServiceReference con un percorso specificato. |
Proprietà
| InlineScript |
Ottiene o imposta un valore che indica se lo script di generazione del proxy è incluso nella pagina come blocco di script in linea o è ottenuto da una richiesta separata. |
| Path |
Ottiene o imposta il percorso del servizio Web a cui si fa riferimento. |
Metodi
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetProxyScript(ScriptManager, Control) |
Fornisce uno script proxy da un oggetto ServiceReference derivato di cui può essere eseguito l'override come una personalizzazione. |
| GetProxyUrl(ScriptManager, Control) |
Fornisce un URL proxy da un oggetto ServiceReference derivato di cui può essere eseguito l'override come una personalizzazione. |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| ToString() |
Restituisce una stringa che rappresenta il valore della proprietà Path o il nome del tipo. |
