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 Web hizmet sınıfı tanımına ScriptServiceAttribute 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 sunucularının örneklerini başlatın; özellikle Web yöntemlerini çağırmak için giriş parametreleri olarak kullanın.
Uyarı
Denetim ServiceReference yalnızca aynı etki alanındaki hizmetler için kullanılabilir.
Web hizmeti konumunu bildirimli olarak tanımlamak için<Services>, aşağıdaki örnekte gösterildiği gibi sayfadaki öğesinin <asp:ScriptManager> içindeki öğesine bir <asp:ServiceReference> öğe ekleyebilir ve ardından özniteliğini Path ayarlayabilirsiniz.
<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 istekle alınıp alınmadığını belirtmek için özelliğini kullanabilirsiniz.
Sınıfın yöntemini kullanarak veya ScriptManagerProxy.Services koleksiyonu aracılığıyla ScriptManager.Services program aracılığıyla bir ServiceReference nesne de ekleyebilirsinizAdd.ServiceReferenceCollection
Oluşturucular
| Name | Description |
|---|---|
| ServiceReference() |
ServiceReference sınıfının yeni bir örneğini başlatır. |
| ServiceReference(String) |
Sınıfın ServiceReference yeni bir örneğini belirtilen bir yolla başlatır. |
Özellikler
| Name | Description |
|---|---|
| InlineScript |
Ara sunucu oluşturma betiğinin sayfaya satır içi betik bloğu olarak eklenip eklenmediğini veya ayrı bir istekle 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
| Name | Description |
|---|---|
| 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) |
Bir özelleştirme olarak geçersiz kılınabilecek türetilmiş ServiceReference bir nesneden bir proxy betiği sağlar. |
| GetProxyUrl(ScriptManager, Control) |
Türetilmiş ServiceReference nesneden bir proxy URL'si özelleştirme olarak geçersiz kılınabilir sağlar. |
| GetType() |
Geçerli örneğin Type alır. (Devralındığı yer: Object) |
| MemberwiseClone() |
Geçerli Objectbasit 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. |
