HttpSimpleClientProtocol Clase

Definición

Espacio de nombres:

System.Web.Services.Protocols

Ensamblado:

System.Web.Services.dll

Representa la clase base para la establecer comunicación con un servicio Web XML mediante los sencillos enlaces de protocolo HTTP-GET y HTTP-POST.

public ref class HttpSimpleClientProtocol abstract : System::Web::Services::Protocols::HttpWebClientProtocol

[System.Runtime.InteropServices.ComVisible(true)]
public abstract class HttpSimpleClientProtocol : System.Web.Services.Protocols.HttpWebClientProtocol

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

Public MustInherit Class HttpSimpleClientProtocol
Inherits HttpWebClientProtocol

Herencia

Object

MarshalByRefObject

Component

WebClientProtocol

HttpWebClientProtocol

HttpSimpleClientProtocol

Derivado

System.Web.Services.Protocols.HttpGetClientProtocol

System.Web.Services.Protocols.HttpPostClientProtocol

Atributos

ComVisibleAttribute

Ejemplos

El ejemplo de código siguiente es una clase de proxy generada por Wsdl.exe para el Math servicio web XML siguiente. La clase de proxy deriva de HttpGetClientProtocol, que deriva de la clase abstracta HttpSimpleClientProtocol .

#using <System.Web.Services.dll>
#using <System.Xml.dll>
#using <System.dll>

using namespace System::Diagnostics;
using namespace System::Xml::Serialization;
using namespace System;
using namespace System::Web::Services::Protocols;
using namespace System::Web::Services;

public ref class MyMath: public System::Web::Services::Protocols::HttpGetClientProtocol
{
public:

   [System::Diagnostics::DebuggerStepThroughAttribute]
   MyMath()
   {
      this->Url = "http://www.contoso.com/math.asmx";
   }

   [System::Diagnostics::DebuggerStepThroughAttribute]
   [System::Web::Services::Protocols::HttpMethodAttribute(System::Web::Services::Protocols::XmlReturnReader::typeid,
   System::Web::Services::Protocols::UrlParameterWriter::typeid)]
   [returnvalue:System::Xml::Serialization::XmlRootAttribute("snippet1>",Namespace="http://www.contoso.com/",IsNullable=false)]
   int Add( String^ num1, String^ num2 )
   {
      array<Object^>^temp0 = {num1,num2};
      return  *dynamic_cast<int^>(this->Invoke( "Add", (String::Concat( this->Url, "/Add" )), temp0 ));
   }

   [System::Diagnostics::DebuggerStepThroughAttribute]
   System::IAsyncResult^ BeginAdd( String^ num1, String^ num2, System::AsyncCallback^ callback, Object^ asyncState )
   {
      array<Object^>^temp1 = {num1,num2};
      return this->BeginInvoke( "Add", (String::Concat( this->Url, "/Add" )), temp1, callback, asyncState );
   }

   [System::Diagnostics::DebuggerStepThroughAttribute]
   int EndAdd( System::IAsyncResult^ asyncResult )
   {
      return  *dynamic_cast<int^>(this->EndInvoke( asyncResult ));
   }
};

using System.Diagnostics;
using System.Xml.Serialization;
using System;
using System.Web.Services.Protocols;
using System.Web.Services;

public class MyMath : System.Web.Services.Protocols.HttpGetClientProtocol {

    [System.Diagnostics.DebuggerStepThroughAttribute()]
    public MyMath()
    {
        this.Url = "http://www.contoso.com/math.asmx";
    }

    [System.Diagnostics.DebuggerStepThroughAttribute()]
    [System.Web.Services.Protocols.HttpMethodAttribute(typeof(System.Web.Services.Protocols.XmlReturnReader), typeof(System.Web.Services.Protocols.UrlParameterWriter))]
    [return: System.Xml.Serialization.XmlRootAttribute("int", Namespace = "http://www.contoso.com/", IsNullable = false)]
    public int Add(string num1, string num2)
    {
        return ((int)(this.Invoke("Add", (this.Url + "/Add"),
            new object[] { num1, num2 })));
    }

    [System.Diagnostics.DebuggerStepThroughAttribute()]
    public System.IAsyncResult BeginAdd(string num1, string num2, System.AsyncCallback callback, object asyncState)
    {
        return this.BeginInvoke("Add", (this.Url + "/Add"),
            new object[] { num1, num2 }, callback, asyncState);
    }

    [System.Diagnostics.DebuggerStepThroughAttribute()]
    public int EndAdd(System.IAsyncResult asyncResult)
    {
        return ((int)(this.EndInvoke(asyncResult)));
    }
}

Option Strict On
Option Explicit On

Imports System.Diagnostics
Imports System.Web.Services
Imports System.Web.Services.Protocols
Imports System.Xml.Serialization


Public Class MyMath
    Inherits System.Web.Services.Protocols.HttpGetClientProtocol
    
    <System.Diagnostics.DebuggerStepThroughAttribute()>  _
    Public Sub New()
        MyBase.New
        Me.Url = "http://www.contoso.com/math.asmx"
    End Sub
    
    <System.Diagnostics.DebuggerStepThroughAttribute(),  _
     System.Web.Services.Protocols.HttpMethodAttribute(GetType(System.Web.Services.Protocols.XmlReturnReader), GetType(System.Web.Services.Protocols.UrlParameterWriter))>  _
    Public Function Add(ByVal num1 As String, ByVal num2 As String) As <System.Xml.Serialization.XmlRootAttribute("int", [Namespace]:="http://www.contoso.com/", IsNullable:=false)> Integer
        Return CType(Me.Invoke("Add", (Me.Url + "/Add"), New Object() {num1, num2}),Integer)
    End Function
    
    <System.Diagnostics.DebuggerStepThroughAttribute()>  _
    Public Function BeginAdd(ByVal num1 As String, ByVal num2 As String, ByVal callback As System.AsyncCallback, ByVal asyncState As Object) As System.IAsyncResult
        Return Me.BeginInvoke("Add", (Me.Url + "/Add"), New Object() {num1, num2}, callback, asyncState)
    End Function
    
    <System.Diagnostics.DebuggerStepThroughAttribute()>  _
    Public Function EndAdd(ByVal asyncResult As System.IAsyncResult) As Integer
        Return CType(Me.EndInvoke(asyncResult),Integer)
    End Function
End Class

El ejemplo de código siguiente es el Math servicio web XML, desde el que se creó la clase de proxy anterior.

#using <System.EnterpriseServices.dll>
#using <System.Web.Services.dll>

using namespace System::Web::Services;
using namespace System;
public ref class Math
{
public:

   [WebMethod]
   int Add( int num1, int num2 )
   {
      return num1 + num2;
   }

};

using System.Web.Services;
using System;

public class Math
{
    [WebMethod]
    public int Add(int num1, int num2)
    {
        return num1 + num2;
    }
}

Imports System.Web.Services

Public Class Math
    <WebMethod()> _
    Public Function Add(num1 As Integer, num2 As Integer)As Integer
    
        Return num1 + num2
    End Function
    
End Class

Comentarios

Esta clase especifica la mayor parte de la implementación para comunicarse con un servicio web XML a través de HTTP mediante codificadores para codificar los parámetros y devolver valores en formatos MIME comunes. Estos codificadores derivan de la MimeFormatter clase . De forma predeterminada, una clase de proxy que deriva de HttpSimpleClientProtocol parámetros de codificación mediante el tipo MIME application/x-www-form-urlencoded y la respuesta en XML sin formato. Sin embargo, los formateadores mime personalizados se pueden especificar mediante el HttpMethodAttribute atributo , pero no hay compatibilidad para integrarlo en una descripción del servicio y una generación de proxy.

Notes to Inheritors: Al invalidar esta clase, puede introducir métodos en la clase derivada que son específicas de un tipo determinado de un servicio web XML. Los métodos simplemente capturan los parámetros y llaman a la clase base para realizar el trabajo de comunicación con el sitio. Si los métodos introducidos son asincrónicos, llame a los BeginInvoke métodos y EndInvoke . Si los métodos introducidos son sincrónicos, llame al Invoke método . El constructor invalidado normalmente establece la Url propiedad en el URI del método de servicio web XML.

La herramienta Lenguaje de descripción de servicios web (Wsdl.exe) genera clases derivadas de HttpSimpleClientProtocol para una descripción de servicio determinada.

Constructores

HttpSimpleClientProtocol()

Inicializa una nueva instancia de la clase HttpSimpleClientProtocol.

Propiedades

AllowAutoRedirect	Obtiene o establece si el cliente sigue de forma automática las redirecciones del servidor. (Heredado de HttpWebClientProtocol)
CanRaiseEvents	Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
ClientCertificates	Obtiene la colección de certificados del cliente. (Heredado de HttpWebClientProtocol)
ConnectionGroupName	Obtiene o establece el nombre del grupo de conexiones para la solicitud. (Heredado de WebClientProtocol)
Container	Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component)
CookieContainer	Obtiene o establece la colección de cookies. (Heredado de HttpWebClientProtocol)
Credentials	Obtiene o establece credenciales de seguridad para la autenticación del cliente de servicios Web XML. (Heredado de WebClientProtocol)
DesignMode	Obtiene un valor que indica si Component está actualmente en modo de diseño. (Heredado de Component)
EnableDecompression	Obtiene o establece un valor que indica si la descompresión está habilitada para este HttpWebClientProtocol. (Heredado de HttpWebClientProtocol)
Events	Obtiene la lista de controladores de eventos asociados a Component. (Heredado de Component)
PreAuthenticate	Obtiene o establece si la autenticación previa está habilitada. (Heredado de WebClientProtocol)
Proxy	Obtiene o establece la información de proxy necesaria para realizar una solicitud de servicios Web XML a través de un firewall. (Heredado de HttpWebClientProtocol)
RequestEncoding	La instancia de Encoding que se utiliza para realizar la solicitud de cliente al servicio Web XML. (Heredado de WebClientProtocol)
Site	Obtiene o establece ISite de Component. (Heredado de Component)
Timeout	Indica el tiempo, en milisegundos, que un cliente de servicios Web XML espera a que llegue una respuesta a una solicitud de servicio Web XML sincrónica. (Heredado de WebClientProtocol)
UnsafeAuthenticatedConnectionSharing	Obtiene o establece un valor que indica si está habilitada la conexión compartida cuando el cliente utiliza la autenticación NTLM para conectarse al servidor Web que hospeda el servicio Web XML. (Heredado de HttpWebClientProtocol)
Url	Obtiene o establece la dirección URL base del servicio Web XML que el cliente solicita. (Heredado de WebClientProtocol)
UseDefaultCredentials	Obtiene o establece un valor que indica si se establece la propiedad Credentials en el valor de la propiedad DefaultCredentials. (Heredado de WebClientProtocol)
UserAgent	Obtiene o establece el valor del encabezado del agente de usuario que se envía con cada solicitud. (Heredado de HttpWebClientProtocol)

Métodos

Abort()	Cancela una solicitud a un método de servicios Web XML. (Heredado de WebClientProtocol)
BeginInvoke(String, String, Object[], AsyncCallback, Object)	Inicia una invocación asincrónica de un método de un servicio Web XML.
CancelAsync(Object)	Cancela una llamada asincrónica a un método de servicios Web XML, a menos que la llamada ya haya finalizado. (Heredado de HttpWebClientProtocol)
CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos que usa Component. (Heredado de Component)
Dispose(Boolean)	Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados. (Heredado de Component)
EndInvoke(IAsyncResult)	Finaliza la invocación asincrónica de un método de servicios Web XML utilizando HTTP.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetService(Type)	Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Heredado de Component)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetWebRequest(Uri)	Crea WebRequest para la dirección URI especificada. (Heredado de HttpWebClientProtocol)
GetWebResponse(WebRequest)	Devuelve una respuesta de una solicitud sincrónica a un método de servicios Web XML. (Heredado de HttpWebClientProtocol)
GetWebResponse(WebRequest, IAsyncResult)	Devuelve una respuesta de una solicitud asincrónica a un método de servicios Web XML. (Heredado de HttpWebClientProtocol)
InitializeLifetimeService()	Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
Invoke(String, String, Object[])	Llama al método de servicio Web XML utilizando HTTP.
InvokeAsync(String, String, Object[], SendOrPostCallback)	Invoca al método especificado de forma asincrónica.
InvokeAsync(String, String, Object[], SendOrPostCallback, Object)	Invoca de forma asincrónica al método especificado mientras mantiene un estado asociado.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
ToString()	Devuelve una String que contiene el nombre del Component, si existe. Este método no se debe invalidar. (Heredado de Component)

Eventos

Disposed

Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose(). (Heredado de Component)

Seguridad para subprocesos

Este tipo es seguro para la ejecución de subprocesos.

Consulte también

• SoapHttpClientProtocol