énumération WS_ENCODING (webservices.h)

  • Article

Les différents encodages (formats de message).

Syntax

typedef enum {
  WS_ENCODING_XML_BINARY_1 = 0,
  WS_ENCODING_XML_BINARY_SESSION_1 = 1,
  WS_ENCODING_XML_MTOM_UTF8 = 2,
  WS_ENCODING_XML_MTOM_UTF16BE = 3,
  WS_ENCODING_XML_MTOM_UTF16LE = 4,
  WS_ENCODING_XML_UTF8 = 5,
  WS_ENCODING_XML_UTF16BE = 6,
  WS_ENCODING_XML_UTF16LE = 7,
  WS_ENCODING_RAW = 8
} WS_ENCODING;

Constantes

 
WS_ENCODING_XML_BINARY_1
Valeur : 0
Encodage XML binaire.


Bien que les données soient toujours dans le xml
Format d’ensemble d’informations, cet encodage entraîne généralement des messages plus petits
qui nécessitent moins de processeur pour produire et consommer.


Cet encodage nécessite SOAP 1.2 (WS_ENVELOPE_VERSION_SOAP_1_2).
WS_ENCODING_XML_BINARY_SESSION_1
Valeur : 1
Encodage de session XML binaire.


Bien que les données soient toujours dans le xml
Format d’ensemble d’informations, cet encodage entraîne généralement des messages plus petits
qui nécessitent moins de processeur pour produire et consommer.


Cet encodage est semblable à WS_ENCODING_XML_BINARY_1 , mais ajoute le
fonctionnalité d’un dictionnaire de session. Étant donné que cet encodage nécessite un
session, il ne peut être utilisé que sur les types de canaux session
(WS_CHANNEL_TYPE_DUPLEX_SESSION).


Le dictionnaire de session est une structure de données gérée par le
côté envoi et réception d’un canal. Dictionnaire de session
est utilisé pour optimiser la transmission des données de chaîne. La première fois
une chaîne particulière est écrite, elle est encodée à l’aide de la chaîne complète
HH:MM:SS. Si la même chaîne est réécrite, elle utilise un plus petit
formulaire tokenisé, ce qui peut réduire la taille des messages.


L’enregistreur des données de chaîne sélectionne les chaînes qui sont candidates pour
le dictionnaire de session en remplissant les champs dictionnaire et id de
structure WS_XML_STRING .


La taille du dictionnaire de session est configurée à l’aide de
WS_CHANNEL_PROPERTY_MAX_SESSION_DICTIONARY_SIZE.


Cet encodage nécessite SOAP 1.2 (WS_ENVELOPE_VERSION_SOAP_1_2).
WS_ENCODING_XML_MTOM_UTF8
Valeur : 2
Encodage MTOM.


L’encodage MTOM optimise les données binaires en évitant les coûts
de conversion de données binaires au format base64. Pour les messages contenant
de grandes quantités de données binaires, ce codage se traduit généralement par une taille plus petite
messages qui nécessitent moins de processeur pour produire et consommer
qu’avec un encodage de texte. Cet encodage n’est généralement pas aussi efficace que
un encodage binaire, cependant.


La partie XML du package MTOM est écrite
en utilisant WS_CHARSET_UTF8, mais peut être dans n’importe quel WS_CHARSET lors de la lecture.
WS_ENCODING_XML_MTOM_UTF16BE
Valeur : 3
Encodage MTOM.


L’encodage MTOM optimise les données binaires en évitant les coûts
de conversion de données binaires au format base64. Pour les messages contenant
de grandes quantités de données binaires, ce codage se traduit généralement par une taille plus petite
messages qui nécessitent moins de processeur pour produire et consommer
qu’avec un encodage de texte. Cet encodage n’est généralement pas aussi efficace que
un encodage binaire, cependant.


La partie XML du package MTOM est écrite
l’utilisation de WS_CHARSET_UTF16BE, mais peut se trouver dans n’importe quel WS_CHARSET lors de la lecture.
WS_ENCODING_XML_MTOM_UTF16LE
Valeur : 4
Encodage MTOM.


L’encodage MTOM optimise les données binaires en évitant les coûts
de conversion de données binaires au format base64. Pour les messages contenant
de grandes quantités de données binaires, ce codage se traduit généralement par une taille plus petite
messages qui nécessitent moins de processeur pour produire et consommer
qu’avec un encodage de texte. Cet encodage n’est généralement pas aussi efficace que
un encodage binaire, cependant.


La partie XML du package MTOM est écrite
l’utilisation de WS_CHARSET_UTF16LE, mais peut se trouver dans n’importe quel WS_CHARSET lors de la lecture.
WS_ENCODING_XML_UTF8
Valeur : 5
Encodage de texte (format XML 1.0).


Les données sont écrites à l’aide de WS_CHARSET_UTF8,
mais peut être dans n’importe quel WS_CHARSET lors de la lecture.
WS_ENCODING_XML_UTF16BE
Valeur : 6
Encodage de texte (format XML 1.0).


Les données sont écrites à l’aide de WS_CHARSET_UTF16BE,
mais peut être dans n’importe quel WS_CHARSET lors de la lecture.
WS_ENCODING_XML_UTF16LE
Valeur : 7
Encodage de texte (format XML 1.0).


Les données sont écrites à l’aide de WS_CHARSET_UTF16LE,
mais peut être dans n’importe quel WS_CHARSET lors de la lecture.
WS_ENCODING_RAW
Valeur : 8

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau | Applications UWP]
En-tête webservices.h