Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source

WebClientProtocol, classe

Spécifie la classe de base associée à tous les proxies de client de service Web XML créés à l'aide d'ASP.NET.

Espace de noms :  System.Web.Services.Protocols
Assembly :  System.Web.Services (dans System.Web.Services.dll)

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

Le type WebClientProtocol expose les membres suivants.

  NomDescription
Méthode protégéeWebClientProtocolInitialise une nouvelle instance de la classe WebClientProtocol.
Début

  NomDescription
Propriété protégéeCanRaiseEventsObtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component.)
Propriété publiqueConnectionGroupNameObtient ou définit le nom du groupe de connexions pour la demande.
Propriété publiqueContainerObtient le IContainer qui contient Component. (Hérité de Component.)
Propriété publiqueCredentialsObtient ou définit les informations d'identification du client de service Web XML.
Propriété protégéeDesignModeObtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component.)
Propriété protégéeEventsObtient la liste des gestionnaires d'événements attachés à ce Component. (Hérité de Component.)
Propriété publiquePreAuthenticateObtient ou définit si la pré-authentification est activée.
Propriété publiqueRequestEncoding Encoding utilisé pour formuler la demande du client au service Web XML.
Propriété publiqueSiteObtient ou définit le ISite de Component. (Hérité de Component.)
Propriété publiqueTimeoutIndique 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.
Propriété publiqueUrlObtient ou définit l'URL de base du service Web XML demandé par le client.
Propriété publiqueUseDefaultCredentialsObtient ou définit une valeur indiquant si la propriété Credentials doit avoir la valeur de la propriété CredentialCache.DefaultCredentials.
Début

  NomDescription
Méthode publiqueAbortAnnule une demande d'une méthode de service Web XML.
Méthode protégéeMembre statiqueAddToCacheAjoutent une instance du gestionnaire de protocole client au cache.
Méthode publiqueCreateObjRefCré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.)
Méthode publiqueDispose()Libère toutes les ressources utilisées par Component. (Hérité de Component.)
Méthode protégéeDispose(Boolean)Libère les ressources non managées utilisées par Component et libère éventuellement les ressources managées. (Hérité de Component.)
Méthode publiqueEquals(Object)Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégéeFinalizeLibère les ressources non managées et exécute d'autres opérations de nettoyage avant la récupération de Component par le garbage collection. (Hérité de Component.)
Méthode protégéeMembre statiqueGetFromCacheObtient une instance d'un gestionnaire de protocole client à partir du cache.
Méthode publiqueGetHashCodeSert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publiqueGetLifetimeServiceRé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.)
Méthode protégéeGetServiceRetourne un objet qui représente un service fourni par Component ou par son Container. (Hérité de Component.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégéeGetWebRequestCrée une instance de WebRequest pour l'uri spécifié. Cette méthode protégée est appelée par l'infrastructure du client de service Web XML afin d'obtenir un nouvel objet de transport WebRequest permettant de transmettre la demande de service Web XML.
Méthode protégéeGetWebResponse(WebRequest)Retourne une réponse à partir d'une demande synchrone auprès d'une méthode de service Web XML.
Méthode protégéeGetWebResponse(WebRequest, IAsyncResult)Retourne une réponse à partir d'une demande asynchrone auprès d'une méthode de service Web XML. Cette méthode protégée est appelée par l'infrastructure du client de service Web XML afin d'obtenir la réponse à une demande de service Web XML asynchrone.
Méthode publiqueInitializeLifetimeServiceObtient 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.)
Méthode protégéeMemberwiseClone()Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode protégéeMemberwiseClone(Boolean)Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject.)
Méthode publiqueToStringRetourne String contenant le nom du Component, s'il existe. Cette méthode ne doit pas être substituée. (Hérité de Component.)
Début

  NomDescription
Événement publicDisposedSe produit lorsque le composant est supprimé par un appel à la méthode Dispose. (Hérité de Component.)
Début

Les propriétés de la classe WebClientProtocol servent à contrôler le comportement du transport utilisé pour transmettre la demande de service Web XML et la réponse. Les propriétés de cette classe sont mappées à des propriétés de WebRequest. Des instances de classes dérivées de WebRequest, telles que HttpWebRequest, sont employées comme mécanisme de transport pour les services Web XML créés à l'aide d'ASP.NET.

Pour communiquer avec un service Web XML, vous devez créer une classe proxy indirectement ou directement dérivée de WebClientProtocol pour le service Web XML à appeler. Au lieu de créer la classe proxy manuellement, vous pouvez avoir recours à l'outil Wsdl.exe pour créer une classe proxy pour une description d'un service Web XML donné. Dans la mesure où WebClientProtocol constitue la classe de base du proxy client, ses propriétés sont présentes dans vos classes proxy. Ces propriétés sont utiles pour contrôler le comportement de demande du protocole de transport sous-jacent. Par exemple, la propriété Credentials vous permet d'appeler des services Web XML authentifiés. Beaucoup de propriétés de WebClientProtocol sont utilisées pour initialiser l'objet WebRequest utilisé pour effectuer la demande Web.

L'exemple suivant est un Web Form ASP.NET qui appelle un service Web XML nommé Math. Dans la fonction EnterBtn_Click, le Web Form définit les informations de proxy et les informations d'identification de client de la classe proxy avant d'appeler la méthode distante de service Web XML.

Note de sécuritéNote de sécurité

Cet exemple a une zone de texte qui accepte l'entrée d'utilisateur, ce qui constitue une menace éventuelle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que l'entrée d'utilisateur n'inclut pas de script ni d'éléments HTML. Pour plus d'informations, consultez Vue d'ensemble des attaques de script.


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

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Les propriétés de cette classe sont copiées dans une nouvelle instance d'un objet WebRequest pour chaque appel à une méthode de service Web XML. S'il est possible d'appeler des méthodes de service Web XML sur la même instance de WebClientProtocol simultanément à partir de différents threads, aucune synchronisation n'a lieu pour garantir qu'un instantané cohérent des propriétés sera transféré à l'objet WebRequest. Par conséquent, si vous devez modifier les propriétés et effectuer des appels de méthode simultanés à partir de différents threads, vous devez utiliser une autre instance du proxy de service Web XML ou assurer vous-même la synchronisation.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft