ServiceReference Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Inscrit un service Web à utiliser dans une page Web.
public ref class ServiceReferencepublic class ServiceReferencetype ServiceReference = classPublic Class ServiceReference- Héritage
-
ServiceReference
Exemples
L’exemple suivant montre comment ajouter une référence à un service Web dans le balisage de page pour appeler les méthodes de service Web à partir du 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>
Remarques
Pour appeler des méthodes de service Web à partir d’ECMAScript (JavaScript), vous devez inclure une référence de service dans la page ASP.NET et appliquer l’attribut ScriptServiceAttribute à la définition de classe de service Web. Si vous incluez une référence de service à un service Web dans la ScriptManager page ASP.NET ou ScriptManagerProxy contrôle, les objets JavaScript sont instanciés dans le navigateur.
Les objets proxy sont utilisés pour effectuer les opérations suivantes :
Effectuer des requêtes asynchrones en JavaScript vers des méthodes de service web,
Initialisez des instances de proxys de types de données serveur, en particulier pour une utilisation en tant que paramètres d’entrée pour appeler des méthodes Web.
Note
Le ServiceReference contrôle ne peut être utilisé que pour les services du même domaine.
Vous pouvez définir l’emplacement du service Web de manière déclarative en ajoutant un <asp:ServiceReference> élément à l’élément à l’intérieur <Services> de l’élément <asp:ScriptManager> de la page, puis en définissant son Path attribut, comme illustré dans l’exemple suivant.
<asp:ScriptManager runat="server" ID="scriptManager">
<Services>
<asp:ServiceReference Path="~/WebServices/SimpleWebService.asmx" />
</Services>
</asp:ScriptManager>
Vous pouvez utiliser la InlineScript propriété pour indiquer si le script de génération de proxy est inclus dans la page en tant que bloc de script inline ou obtenu par une demande distincte.
Vous pouvez également ajouter par programmation un ServiceReference objet par le biais de la ou ScriptManagerProxy.Services de la collection à l’aide ScriptManager.Services de la Add méthode de la ServiceReferenceCollection classe.
Constructeurs
| Nom | Description |
|---|---|
| ServiceReference() |
Initialise une nouvelle instance de la classe ServiceReference. |
| ServiceReference(String) |
Initialise une nouvelle instance de la ServiceReference classe avec un chemin d’accès spécifié. |
Propriétés
| Nom | Description |
|---|---|
| InlineScript |
Obtient ou définit une valeur qui indique si le script de génération de proxy est inclus dans la page en tant que bloc de script inline ou obtenu par une demande distincte. |
| Path |
Obtient ou définit le chemin d’accès du service Web référencé. |
Méthodes
| Nom | Description |
|---|---|
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetProxyScript(ScriptManager, Control) |
Fournit un script proxy à partir d’un objet dérivé qui peut être substitué ServiceReference en tant que personnalisation. |
| GetProxyUrl(ScriptManager, Control) |
Fournit une URL de proxy à partir d’un objet dérivé peut être substituée ServiceReference en tant que personnalisation. |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ToString() |
Retourne une chaîne qui représente la valeur de la Path propriété ou du nom de type. |
