ServiceReference ServiceReference ServiceReference ServiceReference Class

定義

Web ページで使用できるように Web サービスを登録します。Registers a Web service for use in a Web page.

public ref class ServiceReference
public class ServiceReference
type ServiceReference = class
Public Class ServiceReference
継承
ServiceReferenceServiceReferenceServiceReferenceServiceReference

次の例は、ページマークアップ内の Web サービスへの参照を追加して、スクリプトから Web サービスメソッドを呼び出す方法を示しています。The following example demonstrates how to add a reference to a Web service in the page markup to call the Web service methods from script.

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

注釈

ECMAScript (JavaScript) から web サービスメソッドを呼び出すには、ASP.NET ページにサービス参照を含め、web サービスクラスScriptServiceAttribute定義に属性を適用する必要があります。To call Web service methods from ECMAScript (JavaScript), you must include a service reference in the ASP.NET page and apply the ScriptServiceAttribute attribute to the Web service class definition. ASP.NET ページ内のコントロールScriptManagerまたはScriptManagerProxyコントロールに Web サービスへのサービス参照を含めると、JavaScript オブジェクトがブラウザーでインスタンス化されます。If you include a service reference to a Web service in the ScriptManager or ScriptManagerProxy control inside the ASP.NET page, JavaScript objects will be instantiated in the browser.

プロキシオブジェクトは、次の操作を実行するために使用されます。The proxy objects will be used to do the following:

  • JavaScript で Web サービスメソッドに非同期要求を行うMake asynchronous requests in JavaScript to Web service methods,

  • サーバーデータ型のプロキシのインスタンスを初期化します。特に、Web メソッドを呼び出すための入力パラメーターとして使用します。Initialize instances of proxies of server data types, in particular for use as input parameters for invoking Web methods.

注意

コントロールServiceReferenceは、同じドメイン内のサービスに対してのみ使用できます。The ServiceReference control can only be used for services in the same domain.

次の例に示すように、ページの要素<asp:ServiceReference><asp:ScriptManager>の要素<Services>に要素を追加し、その属性を設定することPathにより、Web サービスの場所を宣言によって定義できます。You can define the Web service location declaratively by adding an <asp:ServiceReference> element to the <Services> element inside the <asp:ScriptManager> element on the page, and then setting its Path attribute, as shown in the following example.

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

InlineScriptプロパティを使用して、プロキシ生成スクリプトをインラインスクリプトブロックとしてページに含めるか、別の要求によって取得するかを指定できます。You might use the InlineScript property to indicate whether the proxy generation script is included in the page as an inline script block or is obtained by a separate request.

ScriptManager.Services ScriptManagerProxy.Services ServiceReference また、ServiceReferenceCollectionクラスのメソッドを使用して、またはコレクションを使用してオブジェクトをプログラムで追加することもできます。AddYou can also programmatically add a ServiceReference object through the ScriptManager.Services or ScriptManagerProxy.Services collection by using the Add method of the ServiceReferenceCollection class.

コンストラクター

ServiceReference() ServiceReference() ServiceReference() ServiceReference()

ServiceReference クラスの新しいインスタンスを初期化します。Initializes a new instance of the ServiceReference class.

ServiceReference(String) ServiceReference(String) ServiceReference(String) ServiceReference(String)

指定されたパスで、ServiceReference クラスの新しいインスタンスを初期化します。Initializes a new instance of the ServiceReference class with a specified path.

プロパティ

InlineScript InlineScript InlineScript InlineScript

プロキシ生成スクリプトをインライン スクリプト ブロックとしてページ内に含めるか、別の要求によって取得させるかを示す値を取得または設定します。Gets or sets a value that indicates whether the proxy generation script is included in the page as an inline script block or is obtained by a separate request.

Path Path Path Path

参照する Web サービスのパスを取得または設定します。Gets or sets the path of the referenced Web service.

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetProxyScript(ScriptManager, Control) GetProxyScript(ScriptManager, Control) GetProxyScript(ScriptManager, Control) GetProxyScript(ScriptManager, Control)

カスタマイズとしてオーバーライド可能な派生 ServiceReference オブジェクトからプロキシ スクリプトを提供します。Provides a proxy script from a derived ServiceReference object that can be overridden as a customization.

GetProxyUrl(ScriptManager, Control) GetProxyUrl(ScriptManager, Control) GetProxyUrl(ScriptManager, Control) GetProxyUrl(ScriptManager, Control)

カスタマイズとしてオーバーライド可能な派生 ServiceReference オブジェクトからプロキシ URL を提供します。Provides a proxy URL from a derived ServiceReference object can be overridden as a customization.

GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Path プロパティまたは型名の値を表す文字列を返します。Returns a string that represents the value of the Path property or the type name.

適用対象

こちらもご覧ください