ServiceReference Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Web sayfasında kullanmak üzere bir Web hizmeti kaydeder.
public ref class ServiceReferencepublic class ServiceReferencetype ServiceReference = classPublic Class ServiceReference- Devralma
-
ServiceReference
Örnekler
Aşağıdaki örnekte, web hizmeti yöntemlerini betikten çağırmak için sayfa işaretlemesinde bir Web hizmetine nasıl başvuru ekleneceği gösterilmektedir.
<%@ 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>
Açıklamalar
ECMAScript'ten (JavaScript) Web hizmeti yöntemlerini çağırmak için, ASP.NET sayfasına bir hizmet başvurusu eklemeniz ve özniteliğini ScriptServiceAttribute Web hizmeti sınıfı tanımına uygulamanız gerekir. ASP.NET sayfasının içindeki veya ScriptManagerProxy denetimine ScriptManager bir Web hizmetine hizmet başvurusu eklerseniz, JavaScript nesnelerinin örneği tarayıcıda oluşturulur.
Proxy nesneleri aşağıdakileri yapmak için kullanılır:
JavaScript'te Web hizmeti yöntemlerine zaman uyumsuz istekler gönderme,
Sunucu veri türlerinin ara sunucu örneklerini başlatın; özellikle web yöntemlerini çağırmak için giriş parametreleri olarak kullanın.
Not
Denetim ServiceReference yalnızca aynı etki alanındaki hizmetler için kullanılabilir.
Web hizmeti konumunu bildirimli olarak tanımlamak için sayfadaki öğesinin içindeki öğeye bir <asp:ServiceReference> öğe ekleyebilir ve aşağıdaki örnekte gösterildiği gibi özniteliğini ayarlayabilirsinizPath.<asp:ScriptManager><Services>
<asp:ScriptManager runat="server" ID="scriptManager">
<Services>
<asp:ServiceReference Path="~/WebServices/SimpleWebService.asmx" />
</Services>
</asp:ScriptManager>
Proxy oluşturma betiğinin InlineScript sayfaya satır içi betik bloğu olarak eklenip eklenmediğini veya ayrı bir istek tarafından alınıp alınmadığını belirtmek için özelliğini kullanabilirsiniz.
Ayrıca, sınıfının yöntemini kullanarak veya ScriptManagerProxy.Services koleksiyonu aracılığıyla ScriptManager.Services program aracılığıyla bir ServiceReference nesne ekleyebilirsinizAdd.ServiceReferenceCollection
Oluşturucular
| ServiceReference() |
ServiceReference sınıfının yeni bir örneğini başlatır. |
| ServiceReference(String) |
Belirtilen bir yol ile sınıfının yeni bir örneğini ServiceReference başlatır. |
Özellikler
| InlineScript |
Ara sunucu oluşturma betiğinin sayfaya satır içi betik bloğu olarak eklenip eklenmediğini veya ayrı bir istek tarafından alınıp alınmadığını belirten bir değer alır veya ayarlar. |
| Path |
Başvuruda bulunan Web hizmetinin yolunu alır veya ayarlar. |
Yöntemler
| Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
| GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
| GetProxyScript(ScriptManager, Control) |
Türetilmiş ServiceReference bir nesneden özelleştirme olarak geçersiz kılınabilecek bir proxy betiği sağlar. |
| GetProxyUrl(ScriptManager, Control) |
Türetilmiş ServiceReference nesneden bir proxy URL'si sağlar, özelleştirme olarak geçersiz kılınabilir. |
| GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
| MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
| ToString() |
Özelliğin değerini Path veya tür adını temsil eden bir dize döndürür. |
