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 zur Verwendung in einer Webseite.
public ref class ServiceReferencepublic class ServiceReferencetype ServiceReference = classPublic Class ServiceReference- Vererbung
-
ServiceReference
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie Sie im Seitenmarkup einen Verweis auf einen Webdienst hinzufügen, um die Webdienstmethoden aus einem 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 auf der seite ASP.NET einen Dienstverweis einschließen und das ScriptServiceAttribute Attribut auf die Webdienstklassendefinition anwenden. Wenn Sie einen Dienstverweis auf einen Webdienst im -Steuerelement oder ScriptManagerProxy auf der ScriptManager ASP.NET-Seite einschließen, werden JavaScript-Objekte im Browser instanziiert.
Die Proxyobjekte werden für die folgenden Aktionen verwendet:
Stellen Sie asynchrone Anforderungen in JavaScript an Webdienstmethoden,
Initialisieren Sie Instanzen von Proxys von Serverdatentypen, insbesondere zur 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 Webdienststandort deklarativ definieren, indem Sie dem Element innerhalb des <Services><asp:ScriptManager> Elements auf der Seite ein <asp:ServiceReference> Element hinzufügen und dann dessen Path Attribut festlegen, 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 Proxygenerierungsskript als Inlineskriptblock auf der Seite enthalten ist oder durch eine separate Anforderung abgerufen wird.
Sie können ein Objekt auch programmgesteuert über die ScriptManager.Services - oder ScriptManagerProxy.Services -Auflistung hinzufügenServiceReference, indem Sie die Add -Methode der ServiceReferenceCollection -Klasse verwenden.
Konstruktoren
| ServiceReference() |
Initialisiert eine neue Instanz der ServiceReference-Klasse. |
| ServiceReference(String) |
Initialisiert eine neue Instanz der ServiceReference-Klasse mit einem angegebenen Pfad. |
Eigenschaften
| InlineScript |
Ruft einen Wert ab, der angibt, ob das Skript zur Proxygenerierung in der Seite als Inline-Skriptblock eingeschlossen oder durch eine separate Anforderung abgerufen wird, oder legt diesen Wert fest. |
| Path |
Ruft den Pfad des Webdiensts ab, auf den verwiesen wird, oder legt diesen fest. |
Methoden
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetProxyScript(ScriptManager, Control) |
Stellt ein Proxyskript von einem abgeleiteten ServiceReference-Objekt bereit, das als Anpassung überschrieben werden kann. |
| GetProxyUrl(ScriptManager, Control) |
Stellt eine Proxy-URL von einem abgeleiteten ServiceReference-Objekt bereit, das als Anpassung überschrieben werden kann. |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die den Wert der Path-Eigenschaft oder den Typnamen darstellt. |
