WS_XML_WRITER_RAW_ENCODING structure (webservices.h)

Utilisé pour indiquer que l’enregistreur doit émettre des octets à partir de caractères en base64 décodés.

Syntaxe

typedef struct _WS_XML_WRITER_RAW_ENCODING {
  WS_XML_WRITER_ENCODING encoding;
} WS_XML_WRITER_RAW_ENCODING;

Membres

encoding

Type de base pour tous les types qui dérivent de WS_XML_WRITER_ENCODING.

Remarques

Cet encodage peut être utile lorsqu’il est souhaitable d’écrire un document non xml arbitraire, peut-être, tout en utilisant l’abstraction WS_XML_WRITER . Dans cet encodage, seuls les caractères représentant des octets encodés en base64 peuvent être écrits, et uniquement à la racine du document. Aucun élément ou commentaire ne peut être écrit. L’enregistreur émet les octets représentés par les caractères codés en base64. Pour prendre en charge le texte sans espace blanc à la racine du document, le writer fonctionne comme si la propriété WS_XML_WRITER_PROPERTY_ALLOW_FRAGMENT avait été spécifiée.

Les caractères en base64 du document ne sont convertis en octets que si nécessaire. Ainsi, par exemple, l’utilisation de WsWriteBytes, qui effectue normalement un encodage en base64 des octets passés, évite en fait toutes les conversions en base64 et constitue le moyen le plus efficace d’écrire des documents dans cet encodage. L’utilisation de WsWriteChars, par exemple, entraîne le décodage physique des caractères en base64 en octets correspondants. En général, l’écriture du document à l’aide d’autres éléments que WsReadBytes, WsPullBytes ou WsPushBytes entraîne la conversion en base64.

Configuration requise