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.
Enregistre un service Web pour une utilisation 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 du service Web à partir d’un 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 le ScriptManager contrôle ou ScriptManagerProxy à l’intérieur de la page ASP.NET, les objets JavaScript sont instanciés dans le navigateur.
Les objets proxy seront 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 les utiliser comme paramètres d’entrée pour appeler des méthodes Web.
Notes
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> sur 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 s’il est obtenu par une requête distincte.
Vous pouvez également ajouter par programmation un ServiceReference objet via la ScriptManager.Services collection ou ScriptManagerProxy.Services à l’aide de la Add méthode de la ServiceReferenceCollection classe .
Constructeurs
| ServiceReference() |
Initialise une nouvelle instance de la classe ServiceReference. |
| ServiceReference(String) |
Initialise une nouvelle instance de la classe ServiceReference avec le chemin spécifié. |
Propriétés
| InlineScript |
Obtient ou définit une valeur qui indique si le script de génération de proxy est inclus dans la page comme un bloc de script inline ou est obtenu par une demande séparée. |
| Path |
Obtient ou définit le chemin d'accès au service Web référencé. |
Méthodes
| Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
| GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
| GetProxyScript(ScriptManager, Control) |
Fournit un script de proxy à partir d’un objet ServiceReference dérivé qui peut être remplacé comme personnalisation. |
| GetProxyUrl(ScriptManager, Control) |
Fournit une URL de proxy à partir d’un objet dérivé ServiceReference qui peut être remplacé à titre de personnalisation. |
| GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
| MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
| ToString() |
Retourne une chaîne qui représente la valeur de la propriété Path ou le nom de type. |
