Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase WebClientProtocol

 

Publicado: octubre de 2016

Especifica la clase base para todos los proxies de cliente de servicios Web XML creados con ASP.NET.

Espacio de nombres:   System.Web.Services.Protocols
Ensamblado:  System.Web.Services (en System.Web.Services.dll)

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Web.Services.Protocols.WebClientProtocol
        System.Web.Services.Protocols.HttpWebClientProtocol

[ComVisibleAttribute(true)]
public abstract class WebClientProtocol : Component

NombreDescripción
System_CAPS_protmethodWebClientProtocol()

Inicializa una nueva instancia de la clase WebClientProtocol.

NombreDescripción
System_CAPS_protpropertyCanRaiseEvents

Obtiene un valor que indica si el componente puede provocar un evento.(Heredado de Component).

System_CAPS_pubpropertyConnectionGroupName

Obtiene o establece el nombre del grupo de conexiones para la solicitud.

System_CAPS_pubpropertyContainer

Obtiene IContainer que contiene Component.(Heredado de Component).

System_CAPS_pubpropertyCredentials

Obtiene o establece las credenciales de seguridad para la autenticación de cliente de servicios Web XML.

System_CAPS_protpropertyDesignMode

Obtiene un valor que indica si la Component está actualmente en modo de diseño.(Heredado de Component).

System_CAPS_protpropertyEvents

Obtiene la lista de controladores de eventos que se adjuntará a este Component.(Heredado de Component).

System_CAPS_pubpropertyPreAuthenticate

Obtiene o establece si está habilitada la autenticación previa.

System_CAPS_pubpropertyRequestEncoding

El Encoding utilizada para realizar la solicitud de cliente al servicio Web XML.

System_CAPS_pubpropertySite

Obtiene o establece la ISite de la Component.(Heredado de Component).

System_CAPS_pubpropertyTimeout

Indica el tiempo que espera un cliente de servicios Web XML para la respuesta a una solicitud de servicio Web XML sincrónica lleguen (en milisegundos).

System_CAPS_pubpropertyUrl

Obtiene o establece la base de la dirección URL del servicio Web XML el cliente está solicitando.

System_CAPS_pubpropertyUseDefaultCredentials

Obtiene o establece un valor que indica si se debe establecer el Credentials en el valor de la CredentialCache.DefaultCredentials propiedad.

NombreDescripción
System_CAPS_pubmethodAbort()

Cancela una solicitud a un método de servicio Web XML.

System_CAPS_protmethodSystem_CAPS_staticAddToCache(Type, Object)

Agregar una instancia del controlador del protocolo de cliente a la memoria caché.

System_CAPS_pubmethodCreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar a un proxy que se utiliza para comunicarse con un objeto remoto.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodDispose()

Libera todos los recursos que usa Component.(Heredado de Component).

System_CAPS_protmethodDispose(Boolean)

Libera los recursos no administrados que usa Component y libera los recursos administrados de forma opcional.(Heredado de Component).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Libera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el elemento Component durante la recolección de elementos no usados.(Heredado de Component).

System_CAPS_protmethodSystem_CAPS_staticGetFromCache(Type)

Obtiene una instancia de un controlador de protocolo de cliente de la memoria caché.

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_protmethodGetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.(Heredado de Component).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_protmethodGetWebRequest(Uri)

Crea un WebRequest instancia especificado uri. Se llama a este método protegido por la infraestructura de cliente de servicios Web XML para obtener un nuevo WebRequest objeto de transporte para transmitir la solicitud de servicio Web XML.

System_CAPS_protmethodGetWebResponse(WebRequest)

Devuelve una respuesta de una solicitud sincrónica a un método de servicio Web XML.

System_CAPS_protmethodGetWebResponse(WebRequest, IAsyncResult)

Devuelve una respuesta de una solicitud asincrónica a un método de servicio Web XML. La infraestructura del cliente de servicios Web XML para obtener la respuesta de una solicitud de servicio Web XML asincrónica llama a este método protegido.

System_CAPS_pubmethodInitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone(Boolean)

Crea una copia superficial del elemento actual MarshalByRefObject objeto.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodToString()

Devuelve un String que contiene el nombre de la Component, si existe. Este método no se debe invalidar.(Heredado de Component).

NombreDescripción
System_CAPS_pubeventDisposed

Se produce cuando el componente se elimina mediante una llamada a la Dispose (método).(Heredado de Component).

Las propiedades de la WebClientProtocol clase se utilizan para controlar el comportamiento del transporte usado para transmitir la solicitud de servicio Web XML y la respuesta. Las propiedades de esta clase corresponden a las propiedades que se encuentran en WebRequest. Instancias de clases derivadas de WebRequest, como HttpWebRequest, se utilizan como mecanismo de transporte para los servicios Web XML creados con ASP.NET.

Para comunicarse con un servicio Web XML, debe crear una clase de proxy que se derive directa o indirectamente de WebClientProtocol para el servicio Web XML que desea llamar. En lugar de crear manualmente la clase de proxy, puede utilizar la herramienta Wsdl.exe para crear una clase de proxy para la descripción del servicio de un servicio Web XML determinado. Puesto que WebClientProtocol es la clase base para el proxy de cliente, sus propiedades encuentra en las clases de proxy. Estas propiedades son útiles para controlar el comportamiento de solicitud del transporte subyacente. Por ejemplo, usar el Credentials propiedad para llamar a servicios Web XML autenticados. Muchos de los WebClientProtocol propiedades se utilizan para inicializar la WebRequest objeto que se usa para realizar la solicitud Web.

El ejemplo siguiente es un formulario Web Forms de ASP.NET, que llama a un servicio Web XML denominado Math. En el EnterBtn_Click función, el formulario Web Forms establece proxy credenciales de cliente y la información de la clase de proxy antes de llamar al método de servicio Web XML remoto.

System_CAPS_security Seguridad Nota

Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para obtener más información, consulta Script Exploits Overview.

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

.NET Framework
Disponible desde 1.1

Las propiedades de esta clase se copian en una nueva instancia de un WebRequest objeto para cada llamada al método de servicio Web XML. Mientras que puede llamar a métodos de servicio Web XML en el mismo WebClientProtocol instancia desde subprocesos diferentes al mismo tiempo, no hay ninguna sincronización hecha para garantizar la transferencia de una instantánea coherente de las propiedades para el WebRequest objeto. Por lo tanto, si tiene que modificar las propiedades y realizar llamadas a métodos simultáneas desde diferentes subprocesos, debe utilizar una instancia diferente de la Web de XML proxy de servicio o proporcionan su propia sincronización.

Volver al principio
Mostrar: