HttpPostClientProtocol Clase

Referencia

Definición

Espacio de nombres:: System.Web.Services.Protocols

Ensamblado:: System.Web.Services.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Clase base para proxies cliente de servicios Web XML que utilizan el protocolo HTTP-POST.

public ref class HttpPostClientProtocol : System::Web::Services::Protocols::HttpSimpleClientProtocol

public class HttpPostClientProtocol : System.Web.Services.Protocols.HttpSimpleClientProtocol

type HttpPostClientProtocol = class
    inherit HttpSimpleClientProtocol

Public Class HttpPostClientProtocol
Inherits HttpSimpleClientProtocol

Herencia: Object

MarshalByRefObject

Component

WebClientProtocol

HttpWebClientProtocol

HttpSimpleClientProtocol
HttpPostClientProtocol

Ejemplos

El ejemplo siguiente es una clase de proxy generada por la utilidad Wsdl.exe para el Math servicio web XML siguiente. La clase de proxy deriva de HttpPostClientProtocol, 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::HttpPostClientProtocol
{
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::HtmlFormParameterWriter::typeid)]
   [returnvalue:System::Xml::Serialization::XmlRootAttribute("snippet1>",Namespace="http://www.contoso.com/",IsNullable=false)]
   int Add( String^ num1, String^ num2 )
   {
      array<Object^>^temp2 = {num1,num2};
      return  *dynamic_cast<int^>(this->Invoke( "Add", (String::Concat( this->Url, "/Add" )), temp2 ));
   }

   [System::Diagnostics::DebuggerStepThroughAttribute]
   System::IAsyncResult^ BeginAdd( String^ num1, String^ num2, System::AsyncCallback^ callback, Object^ asyncState )
   {
      array<Object^>^temp3 = {num1,num2};
      return this->BeginInvoke( "Add", (this->Url + "/Add" ), temp3, 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.HttpPostClientProtocol
{
    [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.HtmlFormParameterWriter))]
    [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.HttpPostClientProtocol
    
    <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.HtmlFormParameterWriter))>  _
    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 siguiente es el Math servicio web XML, desde el que se creó la clase de proxy anterior.

<%@ WebService Language="C#" Class="Math"%>
 using System.Web.Services;
 using System;
 
 public class Math {
      [ WebMethod ]
      public int Add(int num1, int num2) {
          return num1+num2;
          }
 }

<%@ WebService Language="VB" Class="Math"%>
Imports System.Web.Services
Imports System

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

Comentarios

Cuando un cliente de servicio web XML usa el protocolo HTTP-POST, los parámetros predeterminados se codifican dentro del cuerpo HTTP mediante reglas de codificación url y usan XML sin formato para la respuesta. Este protocolo usa clases que derivan de MimeFormatter para codificar parámetros y devolver valores en formatos MIME estándar. Los codificadores que se van a usar se especifican en la descripción del servicio.

Si va a crear un cliente de servicio web XML mediante ASP.NET, es necesario crear una clase de proxy que derive indirectamente o directamente de WebClientProtocol para el servicio web XML al que desea llamar. Cuando el cliente del servicio web XML llama mediante HTTP, derive la clase HttpSimpleClientProtocolde proxy , que a su vez deriva de WebClientProtocol.

HttpGetClientProtocol y HttpPostClientProtocol derivan de HttpSimpleClientProtocol, proporcionando la compatibilidad para llamar a un método de servicio web XML mediante HTTP-GET y HTTP-POST respectivamente. Los clientes que llaman a un servicio web XML mediante SOAP deben derivar de SoapHttpClientProtocol.

Para obtener más información sobre cómo crear una clase de proxy, vea Crear un proxy de servicio web XML.

Constructores

HttpPostClientProtocol()

Inicializa una nueva instancia de la clase HttpPostClientProtocol.

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. (Heredado de HttpSimpleClientProtocol)
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. (Heredado de HttpSimpleClientProtocol)
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()	Obsoletos. 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 una instancia de WebRequest para la URI especificada.
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()	Obsoletos. 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. (Heredado de HttpSimpleClientProtocol)
InvokeAsync(String, String, Object[], SendOrPostCallback)	Invoca al método especificado de forma asincrónica. (Heredado de HttpSimpleClientProtocol)
InvokeAsync(String, String, Object[], SendOrPostCallback, Object)	Invoca de forma asincrónica al método especificado mientras mantiene un estado asociado. (Heredado de HttpSimpleClientProtocol)
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)

Se aplica a

Compartir vía