ServiceReference 클래스

정의

웹 페이지에서 사용할 웹 서비스를 등록합니다.Registers a Web service for use in a Web page.

public ref class ServiceReference
public class ServiceReference
type ServiceReference = class
Public Class ServiceReference
상속
ServiceReference

예제

다음 예제에서는 웹 서비스에 대 한 참조를 페이지 태그에 추가 하 여 스크립트에서 웹 서비스 메서드를 호출 하는 방법을 보여 줍니다.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)에서 웹 서비스 메서드를 호출 하려면 ASP.NET 페이지에 서비스 참조를 포함 하 고 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 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에서 웹 서비스 메서드에 비동기 요청을 만듭니다.Make asynchronous requests in JavaScript to Web service methods,

  • 웹 메서드 호출을 위한 입력 매개 변수로 사용 하기 위해 특히 서버 데이터 형식의 프록시 인스턴스를 초기화 합니다.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> 내 요소에 요소를 추가 하 <Services> <asp:ScriptManager>Path 다음 예제와 같이 특성을 설정 하 여 웹 서비스 위치를 선언적으로 정의할 수 있습니다.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.

ServiceReference ScriptManager.Services ScriptManagerProxy.Services 클래스의 메서드를 사용 하 여 프로그래밍 방식으로 또는 컬렉션을 통해 개체를 추가할 수도 있습니다 Add ServiceReferenceCollection .You 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 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the ServiceReference class.

ServiceReference(String)

지정된 경로를 사용하여 ServiceReference 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the ServiceReference class with a specified path.

속성

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

참조되는 웹 서비스의 경로를 가져오거나 설정합니다.Gets or sets the path of the referenced Web service.

메서드

Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetProxyScript(ScriptManager, Control)

사용자 지정으로 재정의할 수 있는 파생된 ServiceReference 개체의 프록시 스크립트를 제공합니다.Provides a proxy script from a derived ServiceReference object that can be overridden as a customization.

GetProxyUrl(ScriptManager, Control)

사용자 지정으로 재정의할 수 있는 파생된 ServiceReference 개체의 프록시 URL을 제공합니다.Provides a proxy URL from a derived ServiceReference object can be overridden as a customization.

GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
ToString()

Path 속성 값이나 형식 이름을 나타내는 문자열을 반환합니다.Returns a string that represents the value of the Path property or the type name.

적용 대상