HttpSimpleClientProtocol Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente la classe de base pour communiquer avec un service Web XML à l’aide des liaisons de protocoles HTTP-GET et HTTP-POST simples.
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
-
HttpSimpleClientProtocol
- 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 communiquer 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érivant des HttpSimpleClientProtocol paramètres encode à l’aide du type MIME codé par application/x-www-form-urlencoded et de la réponse en XML brut. Les formateur mime personnalisés peuvent être spécifiés à l’aide de l’attribut HttpMethodAttribute . Toutefois, il n’existe aucune prise en charge de l’intégration dans une description de service et une génération de proxy.
Notes to Inheritors: Lorsque vous remplacez cette classe, vous pouvez introduire des méthodes dans la classe dérivée qui sont 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 méthodes et EndInvoke les BeginInvoke méthodes. Si les méthodes introduites sont synchrones, appelez la Invoke méthode. Le constructeur substitué 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 d’une description de HttpSimpleClientProtocol service donnée.
Constructeurs
| Nom | Description |
|---|---|
| HttpSimpleClientProtocol() |
Initialise une nouvelle instance de la classe HttpSimpleClientProtocol. |
Propriétés
| Nom | Description |
|---|---|
| AllowAutoRedirect |
Obtient ou définit si le client suit automatiquement les redirections de serveur. (Hérité de HttpWebClientProtocol) |
| CanRaiseEvents |
Obtient une valeur indiquant 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 demande. (Hérité de WebClientProtocol) |
| Container |
Obtient le IContainer fichier qui contient le 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 de sécurité pour l’authentification du client du service web XML. (Hérité de WebClientProtocol) |
| DesignMode |
Obtient une valeur qui indique si la Component valeur est actuellement en mode création. (Hérité de Component) |
| EnableDecompression |
Obtient ou définit une valeur qui indique si la décompression est activée pour cela HttpWebClientProtocol. (Hérité de HttpWebClientProtocol) |
| Events |
Obtient la liste des gestionnaires d’événements qui sont 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 de proxy pour effectuer une demande de service web XML via un pare-feu. (Hérité de HttpWebClientProtocol) |
| RequestEncoding |
Utilisé Encoding pour effectuer la requête cliente au service Web XML. (Hérité de WebClientProtocol) |
| Site |
Obtient ou définit le ISiteComponent. (Hérité de Component) |
| Timeout |
Indique l’heure à laquelle un client de service web XML attend la réponse à une demande de service Web XML synchrone à arriver (en millisecondes). (Hérité de WebClientProtocol) |
| UnsafeAuthenticatedConnectionSharing |
Obtient ou définit une valeur qui indique si le partage de connexion est activé lorsque le client utilise l’authentification NTLM pour se connecter au serveur Web qui héberge 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 qui indique s’il faut définir la Credentials propriété sur la valeur de la DefaultCredentials propriété. (Hérité de WebClientProtocol) |
| UserAgent |
Obtient ou définit la valeur de l’en-tête de l’agent utilisateur envoyé avec chaque requête. (Hérité de HttpWebClientProtocol) |
Méthodes
| Nom | Description |
|---|---|
| Abort() |
Annule une demande à 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 qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject) |
| Dispose() |
Libère toutes les ressources utilisées par le Component. (Hérité de Component) |
| Dispose(Boolean) |
Libère les ressources non managées utilisées par les Component ressources gérées et libère éventuellement les ressources managées. (Hérité de Component) |
| EndInvoke(IAsyncResult) |
Termine l’appel asynchrone d’une méthode de service Web XML à l’aide de HTTP. |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetHashCode() |
Sert 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 actuel 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 le Component ou par son Container. (Hérité de Component) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| GetWebRequest(Uri) |
Crée un WebRequest URI spécifié. (Hérité de HttpWebClientProtocol) |
| GetWebResponse(WebRequest, IAsyncResult) |
Retourne une réponse d’une requête asynchrone à une méthode de service Web XML. (Hérité de HttpWebClientProtocol) |
| GetWebResponse(WebRequest) |
Retourne une réponse d’une requête synchrone à 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 à l’aide de HTTP. |
| InvokeAsync(String, String, Object[], SendOrPostCallback, Object) |
Appelle la méthode spécifiée de façon asynchrone tout en conservant un état associé. |
| InvokeAsync(String, String, Object[], SendOrPostCallback) |
Appelle la méthode spécifiée de façon asynchrone. |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| MemberwiseClone(Boolean) |
Crée une copie superficielle de l’objet actuel MarshalByRefObject . (Hérité de MarshalByRefObject) |
| ToString() |
Retourne un String nom contenant le nom du Component, le cas échéant. Cette méthode ne doit pas être remplacée. (Hérité de Component) |
Événements
| Nom | Description |
|---|---|
| Disposed |
Se produit lorsque le composant est supprimé par un appel à la Dispose() méthode. (Hérité de Component) |
S’applique à
Cohérence de thread
Ce type est thread safe.