ServiceReference Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Registriert einen Webdienst für die Verwendung auf einer Webseite.
public ref class ServiceReferencepublic class ServiceReferencetype ServiceReference = classPublic Class ServiceReference- Vererbung
-
ServiceReference
Beispiele
Das folgende Beispiel veranschaulicht, wie Sie einen Verweis auf einen Webdienst im Seitenmarkup hinzufügen, um die Webdienstmethoden aus Skript aufzurufen.
<%@ 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>
Hinweise
Um Webdienstmethoden aus ECMAScript (JavaScript) aufzurufen, müssen Sie einen Dienstverweis in die seite ASP.NET einschließen und das ScriptServiceAttribute Attribut auf die Webdienstklassendefinition anwenden. Wenn Sie einen Dienstverweis auf einen Webdienst in der ScriptManagerScriptManagerProxy ASP.NET-Seite oder steuerelement einfügen, werden JavaScript-Objekte im Browser instanziiert.
Die Proxyobjekte werden verwendet, um Folgendes auszuführen:
Asynchrone Anforderungen in JavaScript an Webdienstmethoden senden,
Initialisieren Sie Instanzen von Proxys von Serverdatentypen, insbesondere für die Verwendung als Eingabeparameter für das Aufrufen von Webmethoden.
Hinweis
Das ServiceReference Steuerelement kann nur für Dienste in derselben Domäne verwendet werden.
Sie können den Webdienstspeicherort deklarativ definieren, indem Sie dem Element innerhalb des <Services><asp:ScriptManager> Elements auf der Seite ein <asp:ServiceReference> Element hinzufügen und dann das Attribut festlegenPath, wie im folgenden Beispiel gezeigt.
<asp:ScriptManager runat="server" ID="scriptManager">
<Services>
<asp:ServiceReference Path="~/WebServices/SimpleWebService.asmx" />
</Services>
</asp:ScriptManager>
Sie können die InlineScript Eigenschaft verwenden, um anzugeben, ob das Skript zur Proxygenerierung in der Seite als Inlineskriptblock enthalten ist oder von einer separaten Anforderung abgerufen wird.
Sie können ein ServiceReference Objekt auch programmgesteuert über die ScriptManager.Services Klasse oder ScriptManagerProxy.Services Auflistung hinzufügen, indem Sie die Add Methode der ServiceReferenceCollection Klasse verwenden.
Konstruktoren
| Name | Beschreibung |
|---|---|
| ServiceReference() |
Initialisiert eine neue Instanz der ServiceReference-Klasse. |
| ServiceReference(String) |
Initialisiert eine neue Instanz der ServiceReference Klasse mit einem angegebenen Pfad. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| InlineScript |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Skript der Proxygenerierung in der Seite als Inlineskriptblock enthalten ist oder von einer separaten Anforderung abgerufen wird. |
| Path |
Dient zum Abrufen oder Festlegen des Pfads des Webdiensts, auf den verwiesen wird. |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetProxyScript(ScriptManager, Control) |
Stellt ein Proxyskript aus einem abgeleiteten ServiceReference Objekt bereit, das als Anpassung überschrieben werden kann. |
| GetProxyUrl(ScriptManager, Control) |
Stellt eine Proxy-URL aus einem abgeleiteten ServiceReference Objekt bereit, kann als Anpassung überschrieben werden. |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die den Wert der Path Eigenschaft oder des Typnamens darstellt. |
