ServiceReference Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Registrerar en webbtjänst för användning på en webbsida.
public ref class ServiceReferencepublic class ServiceReferencetype ServiceReference = classPublic Class ServiceReference- Arv
-
ServiceReference
Exempel
I följande exempel visas hur du lägger till en referens till en webbtjänst i sidmarkeringen för att anropa webbtjänstmetoderna från skriptet.
<%@ 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>
Kommentarer
Om du vill anropa webbtjänstmetoder från ECMAScript (JavaScript) måste du inkludera en tjänstreferens på sidan ASP.NET och tillämpa attributet ScriptServiceAttribute på webbtjänstklassdefinitionen. Om du inkluderar en tjänstreferens till en webbtjänst på ScriptManager eller ScriptManagerProxy kontroll på sidan ASP.NET, instansieras JavaScript-objekt i webbläsaren.
Proxyobjekten används för att göra följande:
Gör asynkrona begäranden i JavaScript till webbtjänstmetoder,
Initiera instanser av proxyservrar för serverdatatyper, särskilt för användning som indataparametrar för att anropa webbmetoder.
Note
Kontrollen ServiceReference kan bara användas för tjänster i samma domän.
Du kan definiera platsen för webbtjänsten deklarativt genom att lägga till <asp:ServiceReference> ett <Services> element i elementet i elementet <asp:ScriptManager> på sidan och sedan ange dess Path attribut, enligt följande exempel.
<asp:ScriptManager runat="server" ID="scriptManager">
<Services>
<asp:ServiceReference Path="~/WebServices/SimpleWebService.asmx" />
</Services>
</asp:ScriptManager>
Du kan använda InlineScript egenskapen för att ange om proxygenereringsskriptet ingår på sidan som ett infogat skriptblock eller hämtas av en separat begäran.
Du kan också programmatiskt lägga till ett ServiceReference objekt via ScriptManager.Services samlingen eller ScriptManagerProxy.Services med hjälp Add av -metoden för ServiceReferenceCollection klassen.
Konstruktorer
| Name | Description |
|---|---|
| ServiceReference() |
Initierar en ny instans av ServiceReference klassen. |
| ServiceReference(String) |
Initierar en ny instans av ServiceReference klassen med en angiven sökväg. |
Egenskaper
| Name | Description |
|---|---|
| InlineScript |
Hämtar eller anger ett värde som anger om proxygenereringsskriptet ingår på sidan som ett infogat skriptblock eller hämtas av en separat begäran. |
| Path |
Hämtar eller anger sökvägen till den refererade webbtjänsten. |
Metoder
| Name | Description |
|---|---|
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetProxyScript(ScriptManager, Control) |
Tillhandahåller ett proxyskript från ett härlett ServiceReference objekt som kan åsidosättas som en anpassning. |
| GetProxyUrl(ScriptManager, Control) |
Tillhandahåller en proxy-URL från ett härlett ServiceReference objekt kan åsidosättas som en anpassning. |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| ToString() |
Returnerar en sträng som representerar värdet för Path egenskapen eller typnamnet. |
