This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

ServiceReference الفئة

Visual Studio 2010

تسجل الخدمة ويب للاستخدام في موقع ويب الصفحة.

مساحة الاسم:  System.Web.UI
التجميع:  System.Web.Extensions (في System.Web.Extensions.dll)

public class ServiceReference

إلى استدعاء الوظائف الخدمة ويب من ECMAScript (JavaScript)، يجب أن يحتوي على مرجع لالخدمة في صفحة ASP.NET وتطبيق ScriptServiceAttributeسمة إلى ويب الخدمة فئة تعريف. إذا قمت بتضمين مرجع الخدمة إلى الخدمة ويب في ScriptManagerأو ScriptManagerProxyعنصر تحكم داخل صفحة ASP.NET، كائنات JavaScript سوف يتم إنشاء في مستعرض.

سيتم استخدام الكائنات الوكيل إلى القيام بما يلي:

  • قم بإجراء طلبات متزامنة في JavaScript ل الخدمة ويب والأساليب

  • Initialize instances of proxies of server data أنواع, in particular for use كـ input parameters for invoking Web methods.

ملاحظةملاحظة

ServiceReference يمكن استخدام عنصر التحكم فقط ل الخدمات في نفس مجال.

You can define the Web service location declaratively by adding an <asp:ServiceReference> element إلى the <Services> element inside the <asp:ScriptManager> element on the الصفحة, and then setting its Path attribute, كـ shown in the following example.

<asp:ScriptManager runat="server" ID="scriptManager">
  <Services>
    <asp:ServiceReference Path="~/WebServices/SimpleWebService.asmx" />
  </Services>
</asp:ScriptManager>

You might use the InlineScript property إلى indicate whether the proxy generation برنامج نصي هو included in the الصفحة كـ an موضعي برنامج نصي block أو هو obtained by a separate request.

يمكنك أيضا برمجياً إضافة ServiceReferenceالكائن من خلال ScriptManager.Servicesأو ScriptManagerProxy.Servicesمجموعة بواسطة استخدام Addأسلوب ServiceReferenceCollectionفئة.

يوضح المثال التالي كيفية إضافة مرجع إلى الخدمة ويب في ترميز صفحة للاتصال الخدمة ويب وظائف من برنامج نصي.


<%@ 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>


يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008, نظام التشغيل Windows Server 2003

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5
إظهار: