WebClientProtocol Classe

Referência

Definição

Namespace:: System.Web.Services.Protocols

Assembly:: System.Web.Services.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Especifica a classe base para todos os proxies de cliente do serviço Web XML criados usando ASP.NET.

public ref class WebClientProtocol abstract : System::ComponentModel::Component

public abstract class WebClientProtocol : System.ComponentModel.Component

[System.Runtime.InteropServices.ComVisible(true)]
public abstract class WebClientProtocol : System.ComponentModel.Component

type WebClientProtocol = class
    inherit Component

[<System.Runtime.InteropServices.ComVisible(true)>]
type WebClientProtocol = class
    inherit Component

Public MustInherit Class WebClientProtocol
Inherits Component

Herança: Object

MarshalByRefObject

Component
WebClientProtocol

Derivado: System.Web.Services.Protocols.HttpWebClientProtocol

Atributos: ComVisibleAttribute

Exemplos

O exemplo a seguir é um ASP.NET Web Form, que chama um serviço Web XML chamado Math. Dentro da EnterBtn_Click função, o Formulário web define informações de proxy e credenciais de cliente na classe proxy antes de chamar o método de serviço Web XML remoto.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma ameaça à segurança em potencial. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos HTML ou script. Para obter mais informações, consulte Visão geral de explorações de script.

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Net" %>
<html>
    <script language="C#" runat="server">
       void EnterBtn_Click(Object Src, EventArgs E) 
          {
             MyMath.Math math = new MyMath.Math();

             // Set the client-side credentials using the Credentials property.
             ICredentials credentials = new NetworkCredential("Joe","mydomain","password");
             math.Credentials = credentials;
             
             // Do not allow the server to redirect the request.
             math.AllowAutoRedirect = false;
             
             int total = math.Add(Convert.ToInt32(Num1.Text), Convert.ToInt32(Num2.Text));
             Total.Text = "Total: " + total.ToString();
         }
 
    </script>
 
    <body>
       <form action="MathClient.aspx" runat=server>
           
          Enter the two numbers you want to add and then press the Total button.
          <p>
          Number 1: <asp:textbox id="Num1" runat=server/>  +
          Number 2: <asp:textbox id="Num2" runat=server/> =
          <asp:button text="Total" Onclick="EnterBtn_Click" runat=server/>
          <p>
          <asp:label id="Total"  runat=server/>
          
       </form>
    </body>
 </html>

<%@ Page Language="VB" %>
<%@ Import Namespace="System.Net" %>
<html>
    <script language="VB" runat="server">
    
        Sub EnterBtn_Click(src As Object, e As EventArgs)
            Dim math As New MyMath.Math()
            
            ' Set the client-side credentials using the Credentials property.
            Dim credentials As New NetworkCredential("Joe", "password", "mydomain")
            math.Credentials = credentials
            
            ' Do not allow the server to redirect the request.
            math.AllowAutoRedirect = False
            
            Dim iTotal As Integer = math.Add(Convert.ToInt32(Num1.Text), Convert.ToInt32(Num2.Text))
            Total.Text = "Total: " & iTotal.ToString()
        End Sub
 
    </script>
 
    <body>
       <form action="MathClient.aspx" runat=server>
           
          Enter the two numbers you want to add and then press the Total button.
          <p>
          Number 1: <asp:textbox id="Num1" runat=server/>  +
          Number 2: <asp:textbox id="Num2" runat=server/> =
          <asp:button text="Total" Onclick="EnterBtn_Click" runat=server/>
          <p>
          <asp:label id="Total"  runat=server/>
          
       </form>
    </body>
 </html>

Comentários

As propriedades da WebClientProtocol classe são usadas para controlar o comportamento do transporte usado para transmitir a solicitação e a resposta do serviço Web XML. As propriedades neste mapa de classe para propriedades encontradas em WebRequest. Instâncias de classes derivadas deWebRequest, por HttpWebRequestexemplo, são usadas como o mecanismo de transporte para serviços Web XML criados usando ASP.NET.

Para se comunicar com um serviço Web XML, você deve criar uma classe proxy derivada indiretamente ou diretamente do WebClientProtocol serviço Web XML que você deseja chamar. Em vez de criar a classe proxy manualmente, você pode usar a ferramenta Wsdl.exe para criar uma classe proxy para uma descrição de serviço de determinado serviço Web XML. Como WebClientProtocol é a classe base do proxy do cliente, você encontrará suas propriedades em suas classes proxy. Essas propriedades são úteis para controlar o comportamento de solicitação do transporte subjacente. Por exemplo, use a Credentials propriedade para chamar serviços Web XML autenticados. Muitas das WebClientProtocol propriedades são usadas para inicializar o WebRequest objeto usado para fazer a solicitação da Web.

Construtores

WebClientProtocol()

Inicializa uma nova instância da classe WebClientProtocol.

Propriedades

CanRaiseEvents	Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component)
ConnectionGroupName	Obtém ou define o nome do grupo de conexões para a solicitação.
Container	Obtém o IContainer que contém o Component. (Herdado de Component)
Credentials	Obtém ou define as credenciais de segurança para a autenticação de cliente do serviço Web XML.
DesignMode	Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component)
Events	Obtém a lista de manipuladores de eventos que estão anexados a este Component. (Herdado de Component)
PreAuthenticate	Obtém ou define se a pré-autenticação está habilitada.
RequestEncoding	O Encoding usado para fazer a solicitação do cliente para o serviço Web XML.
Site	Obtém ou define o ISite do Component. (Herdado de Component)
Timeout	Indica o tempo que um cliente do serviço Web XML aguarda a resposta até que uma solicitação síncrona de serviço Web XML seja recebida (em milissegundos).
Url	Obtém ou define a URL base do serviço Web XML que está sendo solicitada pelo cliente.
UseDefaultCredentials	Obtém ou define um valor que indica se deseja definir a propriedade Credentials para o valor da propriedade DefaultCredentials.

Métodos

Abort()	Cancela uma solicitação para um método de serviço Web XML.
AddToCache(Type, Object)	Adicionar uma instância do manipulador de protocolo de cliente ao cache.
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Libera todos os recursos usados pelo Component. (Herdado de Component)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo Component e opcionalmente libera os recursos gerenciados. (Herdado de Component)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetFromCache(Type)	Obtém uma instância de um manipulador de protocolo de cliente do cache.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetService(Type)	Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetWebRequest(Uri)	Cria uma instância WebRequest para o `uri` especificado. Esse método protegido é chamado pela infraestrutura de cliente de serviço Web XML para obter um novo objeto de transporte WebRequest para transmitir a solicitação de serviço Web XML.
GetWebResponse(WebRequest)	Retorna uma resposta de uma solicitação síncrona para um método de serviço Web XML.
GetWebResponse(WebRequest, IAsyncResult)	Retorna uma resposta de uma solicitação assíncrona para um método de serviço Web XML. Este método protegido é chamado pela infraestrutura do cliente de serviço Web XML para obter a resposta de uma solicitação de serviço Web XML assíncrona.
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
ToString()	Retorna um String que contém o nome do Component, se houver. Esse método não deve ser substituído. (Herdado de Component)

Eventos

Disposed

Ocorre quando o componente é disposto por uma chamada ao método Dispose().

(Herdado de Component)

Aplica-se a

Acesso thread-safe

As propriedades dessa classe são copiadas para uma nova instância de um WebRequest objeto para cada chamada de método de serviço Web XML. Embora você possa chamar métodos de serviço Web XML na mesma WebClientProtocol instância de threads diferentes ao mesmo tempo, não há nenhuma sincronização feita para garantir que um instantâneo consistente das propriedades seja transferido para o WebRequest objeto. Portanto, se você precisar modificar as propriedades e fazer chamadas de método simultâneas de threads diferentes, deverá usar uma instância diferente do proxy do serviço Web XML ou fornecer sua própria sincronização.