|
|
 |
| Solutions hébergement |
|
| Support Dot NET. |
| | |
| |
Source : Les laboratoires Microsoft
|
| |
Marshaling des types de services Web XML
Cette section explique que différents types de données peuvent être passés et retournés par des méthodes Web Service. Comme l'implémentation des services Web XML vient coiffer l'architecture de sérialisation XML, elle prend en charge un grand nombre de types de données. Le tableau suivant énumère les types de données pris en charge pour les méthodes Web Service lors de l'utilisation du protocole SOAP (par exemple, à l'aide du proxy généré par l'outil Web Services Description Language, WSDL.exe).
| Type | Description |
|---|
| Types primitifs | La liste complète des types primitifs pris en charge est la suivante : String, Char, Byte, Boolean, Int16, Int32, Int64, UInt16, UInt32, UInt64, Single, Double, Guid, Decimal, DateTime (comme timeInstant de XML), DateTime (comme date de XML), DateTime (comme heure de XML) et XmlQualifiedName (comme QName de XML).
|
| Types Enum | Types d'énumération, tels que "public enum color { red=1, blue=2 }" |
| Tableaux de primitives, énumérations | Tableaux des primitives ci-dessus, telles que string[] et int[] |
| Classes et structures | Types de classes et de structures avec champs et propriétés publics. Les propriétés et champs publics sont sérialisés. |
| Tableaux de classes (structures) | Tableaux des classes et structures ci-dessus. |
| DataSet | Types de DataSets ADO.NET (pour obtenir un exemple, consultez la section suivante). Les DataSets peuvent aussi s'afficher en tant que champs dans des structures ou des classes.
Remarque : Microsoft Visual Studio.NET et l'utilitaire XSD.EXE du Kit de développement prennent en charge l'affectation d'un type fort à un DataSet.
Ces outils génèrent une classe qui hérite du DataSet pour produire DataSet1, en ajoutant plusieurs méthodes/propriétés/etc. propres à un schéma XML particulier. Si vous passez le DataSet, les services Web transmettent toujours le schéma avec les données (afin de pouvoir déterminer les tableaux et colonnes que vous passez), ainsi que leur type (par exemple : int, string). Si vous passez une sous-classe du DataSet (telle que DataSet1), les services Web supposent que vous ajoutez des tableaux/colonnes dans le constructeur et qu'ils représentent votre schéma.
|
| Tableaux de DataSets | Tableaux des DataSets ci-dessus. |
| XmlNode |
XmlNode est une représentation en mémoire d'un fragment XML (tel qu'un modèle objet de document XML rudimentaire). Par exemple, "<comment>C'est<b>absolument</b> parfait</comment>" peut être enregistré dans un XmlNode.Vous pouvez passer des XmlNodes en tant que paramètres. Ils sont ajoutés au reste du document XML passé au service Web (les autres paramètres) de manière conforme à SOAP. La même remarque s'applique aux valeurs de retour. Cela vous permet de passer ou de retourner un document XML dont la structure est modifiée d'un appel à l'autre ou dont vous ne connaissez pas tous les types passés. XmlNode peut aussi s'afficher en tant que champ dans des structures ou des classes.
|
| Tableaux de XmlNode | Tableaux des XmlNodes ci-dessus. |
Valeurs de retour : Que vous appeliez un service Web à l'aide de SOAP ou de HTTP GET/POST, tous les types ci-dessus sont pris en charge pour les valeurs de retour.
Paramètres : Les paramètres par valeur et par référence (entrée/sortie) sont pris en charge lors de l'utilisation du protocole SOAP. Les paramètres par référence peuvent envoyer la valeur de deux manières : envoi au serveur et retour au client. Lors du passage des paramètres d'entrée à un service Web à l'aide de HTTP GET/POST, seul un ensemble limité de types de données est pris en charge et il doit s'agir de paramètres par valeur. Les types pris en charge par les paramètres HTTP GET/POST sont énumérés ci-dessous :
| Type | Description |
|---|
| Types primitifs (limités) | La plupart des types primitifs standard. La liste complète des types primitifs pris en charge est la suivante : Int32, String, Int16, Int64, Boolean, Single, Double, Decimal, DateTime, UInt16, UInt32, UInt64 et Currency.
Du point de vue du client, tous ces types sont transformés en chaînes.
|
| Types d'énumération | Types d'énumération, tels que "public enum color { red=1, blue=2 }".
Du point de vue du client, les énumérations deviennent des classes avec une chaîne constante statique pour chaque valeur.
|
| Tableaux de primitives, énumérations | Tableaux des primitives ci-dessus, telles que string[] et int[] |
L'exemple suivant illustre l'utilisation des types énumérés ci-dessus, à l'aide d'un proxy SOAP généré à partir de WSDL.exe. Remarquez que comme plusieurs classes publiques sont définies dans le fichier .asmx, vous devez spécifier celle que vous souhaitez traiter comme la classe WebService à l'aide de l'attribut « Class » de la directive WebService :
<%@ WebService Language="C#" Class="DataTypes" %>
- La méthode SayHello illustre le retour d'un String par un service.
- La méthode SayHelloName retourne un String et prend également un String comme paramètre.
- La méthode GetIntArray illustre le retour d'un tableau d'entiers.
- La méthode GetMode retourne une valeur enum.
- La méthode GetOrder retourne une classe (qui est presque identique à une structure dans cet exemple).
- La méthode GetOrders retourne un tableau d'objets Order.
À l'aide de l'outil de ligne de commande pour la génération de proxy WSDL.exe, le marshaling de ces types de données est transparent pour l'application cliente consommatrice. Vous trouverez ci-dessous une application exemple cliente pour le service Web XML décrit plus haut :
|
|
|
Nos serveurs
sont désormais des serveurs
Pentium 3 Ghz, 1 Go Ram
|
La
formule de base est à 10
Euros TTC / mois
Si vous avez des besoins plus spécifiques (composants,
espace disque...), nous sommes la pour répondre à
vos questions. |
| Rappel : les
frais d'installation sont gratuits |
|
|
|
Vérifiez
