ServiceReference Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendaftarkan layanan Web untuk digunakan di halaman Web.
public ref class ServiceReferencepublic class ServiceReferencetype ServiceReference = classPublic Class ServiceReference- Warisan
-
ServiceReference
Contoh
Contoh berikut menunjukkan cara menambahkan referensi ke layanan Web di markup halaman untuk memanggil metode layanan Web dari skrip.
<%@ 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>
Keterangan
Untuk memanggil metode layanan Web dari ECMAScript (JavaScript), Anda harus menyertakan referensi layanan di halaman ASP.NET dan menerapkan ScriptServiceAttribute atribut ke definisi kelas layanan Web. Jika Anda menyertakan referensi layanan ke layanan Web di atau ScriptManagerProxy kontrol di ScriptManager dalam halaman ASP.NET, objek JavaScript akan dibuat di browser.
Objek proksi akan digunakan untuk melakukan hal berikut:
Membuat permintaan asinkron di JavaScript ke metode layanan Web,
Menginisialisasi instans proksi jenis data server, khususnya untuk digunakan sebagai parameter input untuk memanggil metode Web.
Catatan
Kontrol ServiceReference hanya dapat digunakan untuk layanan di domain yang sama.
Anda dapat menentukan lokasi layanan Web secara deklaratif dengan menambahkan <asp:ServiceReference> elemen ke <Services> elemen di dalam <asp:ScriptManager> elemen di halaman, lalu mengatur atributnya Path , seperti yang ditunjukkan dalam contoh berikut.
<asp:ScriptManager runat="server" ID="scriptManager">
<Services>
<asp:ServiceReference Path="~/WebServices/SimpleWebService.asmx" />
</Services>
</asp:ScriptManager>
Anda dapat menggunakan InlineScript properti untuk menunjukkan apakah skrip pembuatan proksi disertakan dalam halaman sebagai blok skrip sebaris atau diperoleh oleh permintaan terpisah.
Anda juga dapat menambahkan ServiceReference objek secara terprogram melalui ScriptManager.Services atau ScriptManagerProxy.Services koleksi dengan menggunakan Add metode ServiceReferenceCollection kelas .
Konstruktor
| ServiceReference() |
Menginisialisasi instans baru kelas ServiceReference. |
| ServiceReference(String) |
Menginisialisasi instans ServiceReference baru kelas dengan jalur tertentu. |
Properti
| InlineScript |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah skrip pembuatan proksi disertakan dalam halaman sebagai blok skrip sebaris atau diperoleh oleh permintaan terpisah. |
| Path |
Mendapatkan atau mengatur jalur layanan Web yang dirujuk. |
Metode
| Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
| GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
| GetProxyScript(ScriptManager, Control) |
Menyediakan skrip proksi dari objek turunan ServiceReference yang dapat ditimpa sebagai penyesuaian. |
| GetProxyUrl(ScriptManager, Control) |
Menyediakan URL proksi dari objek turunan ServiceReference dapat ditimpa sebagai penyesuaian. |
| GetType() |
Mendapatkan dari instans Type saat ini. (Diperoleh dari Object) |
| MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
| ToString() |
Mengembalikan string yang mewakili nilai Path properti atau nama jenis. |
