Home Biblioteca Aprender Galeria Downloads Suporte Comunidade Fóruns
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original
Este tópico ainda não foi avaliado como - Avalie este tópico

Classe ServiceReference

.NET Framework 4.5

Registra um serviço da Web para uso em uma página da Web.

System.Object
  System.Web.UI.ServiceReference

Namespace:  System.Web.UI
Assembly:  System.Web.Extensions (em System.Web.Extensions.dll)
C#
C++
F#
VB
Copiar 
public class ServiceReference

O tipo ServiceReference expõe os membros a seguir.

  NomeDescrição
Método públicoServiceReference()Inicializa uma nova instância da classe ServiceReference.
Método públicoServiceReference(String)Inicializa uma nova instância da ServiceReference classe com um caminho especificado.
Superior
  NomeDescrição
Propriedade públicaInlineScriptObtém ou define um valor que indica se o script de geração de proxy está incluído na página como um bloco de script embutido ou é obtido com uma solicitação separada.
Propriedade públicaPathObtém ou define o caminho do serviço Web referenciado.
Superior
  NomeDescrição
Método públicoEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método protegidoFinalize Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)
Método públicoGetHashCodeServe como uma função hash para um tipo específico. (Herdado de Object.)
Método protegidoGetProxyScriptFornece um script de proxy a partir de um derivado ServiceReference objeto que pode ser substituído como uma personalização.
Método protegidoGetProxyUrlFornece uma URL de proxy a partir de um derivado ServiceReference objeto pode ser substituído como uma personalização.
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método protegidoMemberwiseCloneCria uma cópia superficial do Object atual. (Herdado de Object.)
Método públicoToStringRetorna um string que representa o valor da Path propriedade ou o nome do tipo. (Substitui Object.ToString().)
Superior

Para chamar métodos de serviço da Web a partir do ECMAScript (JavaScript), você deve incluir uma referência de serviço na página ASP.NET e aplicar o ScriptServiceAttribute de atributo para a definição de classe de serviço da Web. Se você incluir uma referência de serviço para um serviço da Web na ScriptManager ou ScriptManagerProxy controle dentro do aplicativo ASP.NET normal, JavaScript objetos serão instanciados no navegador.

Os objetos de proxy serão usados para fazer o seguinte:

  • Fazer solicitações assíncronas em JavaScript para métodos de serviço da Web

  • Inicialize instâncias de proxies de tipos de dados do servidor, em particular para uso como parâmetros de entrada para invocar os métodos da Web.

ObservaçãoObservação

O ServiceReference controle só pode ser usado para serviços no mesmo domínio.

Você pode definir o local do serviço Web declarativamente adicionando um <asp:ServiceReference> elemento para o <Services> elemento dentro do <asp:ScriptManager> elemento na página e, em seguida, configuração sua Path de atributo, como mostrado no exemplo a seguir.

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

Você pode usar o InlineScript propriedade para indicar se o script de geração de proxy está incluído na página como um bloco de script embutido ou é obtido com uma solicitação separada.

Também programaticamente, você pode adicionar um ServiceReference por meio de objeto a ScriptManager.Services ou ScriptManagerProxy.Services coleção usando o Add método da ServiceReferenceCollection classe.

O exemplo a seguir demonstra como adicionar uma referência a um serviço da Web na marcação da página para chamar os métodos do serviço da Web a partir do script.

C#
VB
Copiar 

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

.NET Framework

Com suporte em: 4.5, 4, 3.5

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte .Requisitos de sistema do NET Framework.
Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.
Isso foi útil para você?
(1500 caracteres restantes)

Contribuições da comunidade

ADICIONAR
© 2013 Microsoft. Todos os direitos reservados.