HttpSimpleClientProtocol Classe

Définition

Représente la classe de base permettant de communiquer avec un service Web XML en utilisant les liaisons de protocoles simples HTTP-GET et HTTP-POST.

public ref class HttpSimpleClientProtocol abstract : System::Web::Services::Protocols::HttpWebClientProtocol
public abstract class HttpSimpleClientProtocol : System.Web.Services.Protocols.HttpWebClientProtocol
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class HttpSimpleClientProtocol : System.Web.Services.Protocols.HttpWebClientProtocol
type HttpSimpleClientProtocol = class
    inherit HttpWebClientProtocol
[<System.Runtime.InteropServices.ComVisible(true)>]
type HttpSimpleClientProtocol = class
    inherit HttpWebClientProtocol
Public MustInherit Class HttpSimpleClientProtocol
Inherits HttpWebClientProtocol
Héritage
Dérivé
Attributs

Exemples

L’exemple de code suivant est une classe proxy générée par Wsdl.exe pour le Math service Web XML ci-dessous. La classe proxy dérive de HttpGetClientProtocol, qui dérive de la classe abstraite 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

L’exemple de code suivant est le Math service Web XML à partir duquel la classe proxy précédente a été créée.

#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

Remarques

Cette classe spécifie la plupart de l’implémentation pour la communication avec un service Web XML via HTTP à l’aide d’encodeurs pour encoder les paramètres et retourner des valeurs dans des formats MIME courants. Ces encodeurs dérivent de la MimeFormatter classe . Par défaut, une classe proxy dérivée d’encode HttpSimpleClientProtocol les paramètres à l’aide du type MIME application/x-www-form-urlencoded et de la réponse en XML brut. Les formateurs mime personnalisés peuvent être spécifiés à l’aide de l’attribut HttpMethodAttribute . Toutefois, il n’y a pas de prise en charge de l’intégration dans une description de service et la génération de proxy.

Notes to Inheritors: Lorsque vous remplacez cette classe, vous pouvez introduire dans la classe dérivée des méthodes spécifiques à un type particulier d’un service Web XML. Les méthodes capturent simplement les paramètres et appellent la classe de base pour effectuer le travail de communication avec le site. Si les méthodes introduites sont asynchrones, appelez les BeginInvoke méthodes et EndInvoke . Si les méthodes introduites sont synchrones, appelez la Invoke méthode . Le constructeur remplacé définit généralement la Url propriété sur l’URI de la méthode de service Web XML.

L’outil Web Services Description Language (Wsdl.exe) génère des classes dérivées de pour une description de HttpSimpleClientProtocol service donnée.

Constructeurs

HttpSimpleClientProtocol()

Initialise une nouvelle instance de la classe HttpSimpleClientProtocol.

Propriétés

AllowAutoRedirect

Obtient ou définit le paramètre indiquant si le client suit automatiquement ou non les redirections du serveur.

(Hérité de HttpWebClientProtocol)
CanRaiseEvents

Obtient une valeur qui indique si le composant peut déclencher un événement.

(Hérité de Component)
ClientCertificates

Obtient la collection de certificats clients.

(Hérité de HttpWebClientProtocol)
ConnectionGroupName

Obtient ou définit le nom du groupe de connexions pour la requête.

(Hérité de WebClientProtocol)
Container

Obtient le IContainer qui contient la Component.

(Hérité de Component)
CookieContainer

Obtient ou définit la collection de cookies.

(Hérité de HttpWebClientProtocol)
Credentials

Obtient ou définit les informations d'identification du client de service Web XML.

(Hérité de WebClientProtocol)
DesignMode

Obtient une valeur qui indique si Component est actuellement en mode design.

(Hérité de Component)
EnableDecompression

Obtient ou définit une valeur qui indique si la décompression est activée pour ce HttpWebClientProtocol.

(Hérité de HttpWebClientProtocol)
Events

Obtient la liste des gestionnaires d'événements attachés à ce Component.

(Hérité de Component)
PreAuthenticate

Obtient ou définit si la pré-authentification est activée.

(Hérité de WebClientProtocol)
Proxy

Obtient ou définit des informations relatives au proxy et permettant de faire passer une demande de service Web XML via un pare-feu.

(Hérité de HttpWebClientProtocol)
RequestEncoding

Encoding utilisé pour formuler la demande du client au service Web XML.

(Hérité de WebClientProtocol)
Site

Obtient ou définit le ISite de Component.

(Hérité de Component)
Timeout

Indique la durée (en millisecondes) pendant laquelle un client de service Web XML attend la réponse à une requête de service Web XML synchrone.

(Hérité de WebClientProtocol)
UnsafeAuthenticatedConnectionSharing

Obtient ou définit une valeur indiquant si le partage de connexion est activé lorsque le client utilise l'authentification NTLM pour se connecter au serveur Web hébergeant le service Web XML.

(Hérité de HttpWebClientProtocol)
Url

Obtient ou définit l'URL de base du service Web XML demandé par le client.

(Hérité de WebClientProtocol)
UseDefaultCredentials

Obtient ou définit une valeur indiquant si la propriété Credentials doit avoir la valeur de la propriété DefaultCredentials.

(Hérité de WebClientProtocol)
UserAgent

Obtient ou définit la valeur de l'en-tête d'agent utilisateur (user agent) accompagnant chaque demande.

(Hérité de HttpWebClientProtocol)

Méthodes

Abort()

Annule une demande d'une méthode de service Web XML.

(Hérité de WebClientProtocol)
BeginInvoke(String, String, Object[], AsyncCallback, Object)

Démarre un appel asynchrone d'une méthode d'un service Web XML.

CancelAsync(Object)

Annule un appel asynchrone à une méthode de service Web XML, sauf si l'appel est déjà terminé.

(Hérité de HttpWebClientProtocol)
CreateObjRef(Type)

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.

(Hérité de MarshalByRefObject)
Dispose()

Libère toutes les ressources utilisées par Component.

(Hérité de Component)
Dispose(Boolean)

Libère les ressources non managées utilisées par Component et libère éventuellement les ressources managées.

(Hérité de Component)
EndInvoke(IAsyncResult)

Met fin à l'appel asynchrone d'une méthode de service Web XML utilisant HTTP.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetLifetimeService()
Obsolète.

Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
GetService(Type)

Retourne un objet qui représente un service fourni par Component ou par son Container.

(Hérité de Component)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
GetWebRequest(Uri)

Crée WebRequest pour l'identificateur URI spécifié

(Hérité de HttpWebClientProtocol)
GetWebResponse(WebRequest)

Retourne une réponse à partir d'une demande synchrone auprès d'une méthode de service Web XML.

(Hérité de HttpWebClientProtocol)
GetWebResponse(WebRequest, IAsyncResult)

Retourne une réponse à partir d'une demande asynchrone auprès d'une méthode de service Web XML.

(Hérité de HttpWebClientProtocol)
InitializeLifetimeService()
Obsolète.

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
Invoke(String, String, Object[])

Appelle une méthode de service Web XML utilisant HTTP.

InvokeAsync(String, String, Object[], SendOrPostCallback)

Appelle la méthode spécifiée de manière asynchrone.

InvokeAsync(String, String, Object[], SendOrPostCallback, Object)

Appelle la méthode spécifiée de manière asynchrone tout en conservant un état associé.

MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.

(Hérité de MarshalByRefObject)
ToString()

Retourne un String contenant le nom du Component, s’il en existe un. Cette méthode ne doit pas être remplacée.

(Hérité de Component)

Événements

Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().

(Hérité de Component)

S’applique à

Cohérence de thread

Ce type est thread-safe.

Voir aussi