ServiceReference ServiceReference ServiceReference ServiceReference Class

Definición

Registra un servicio Web para su uso en una página web.Registers a Web service for use in a Web page.

public ref class ServiceReference
public class ServiceReference
type ServiceReference = class
Public Class ServiceReference
Herencia
ServiceReferenceServiceReferenceServiceReferenceServiceReference

Ejemplos

El ejemplo siguiente muestra cómo agregar una referencia a un servicio Web en el marcado de página para llamar a los métodos de servicio Web desde el script.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>

Comentarios

Para llamar a métodos de servicio Web de ECMAScript (JavaScript), debe incluir una referencia de servicio en la página ASP.NET y aplicar el ScriptServiceAttribute atributo a la definición de clase de servicio Web.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. Si se incluye una referencia de servicio a un servicio Web en el ScriptManager o ScriptManagerProxy control dentro de la página ASP.NET, se crearán instancias de objetos en el Explorador de 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.

Los objetos proxy, se usarán para hacer lo siguiente:The proxy objects will be used to do the following:

  • Realizar solicitudes asincrónicas en JavaScript a los métodos de servicio Web,Make asynchronous requests in JavaScript to Web service methods,

  • Inicializar instancias de proxy de tipos de datos del servidor, en particular para su uso como parámetros de entrada para invocar los métodos Web.Initialize instances of proxies of server data types, in particular for use as input parameters for invoking Web methods.

Nota

El ServiceReference control sólo puede usarse para servicios en el mismo dominio.The ServiceReference control can only be used for services in the same domain.

Puede definir la ubicación del servicio Web de forma declarativa mediante la adición de un <asp:ServiceReference> elemento a la <Services> elemento dentro de la <asp:ScriptManager> elemento en la página y, a continuación, configuración su Path atributo, como se muestra en el ejemplo siguiente.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>  

Puede usar el InlineScript propiedad para indicar si el script de generación de proxy se incluye en la página como bloque de scripts alineado o se obtiene mediante una solicitud independiente.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.

Puede agregar mediante programación un ServiceReference objeto a través de la ScriptManager.Services o ScriptManagerProxy.Services colección utilizando el Add método de la ServiceReferenceCollection clase.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.

Constructores

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

Inicializa una nueva instancia de la clase ServiceReference.Initializes a new instance of the ServiceReference class.

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

Inicializa una nueva instancia de la clase ServiceReference con una ruta de acceso especificada.Initializes a new instance of the ServiceReference class with a specified path.

Propiedades

InlineScript InlineScript InlineScript InlineScript

Obtiene o establece un valor que indica si el script de generación de los proxy está insertado en la página como bloque de scripts alineado o se obtiene mediante una solicitud independiente.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

Obtiene o establece la ruta de acceso del servicio Web al que se ha hecho referencia.Gets or sets the path of the referenced Web service.

Métodos

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

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

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

Sirve como la función hash predeterminada.Serves as the default hash function.

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

Proporciona un script de proxy de un objeto ServiceReference derivado que se puede invalidar como una personalización.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)

Proporciona una dirección URL de proxy de un objeto ServiceReference derivado que se puede invalidar como una personalización.Provides a proxy URL from a derived ServiceReference object can be overridden as a customization.

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

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

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

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

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

Devuelve una cadena que representa el valor de la propiedad Path o el nombre de tipo.Returns a string that represents the value of the Path property or the type name.

Se aplica a

Consulte también: