énumération WS_XML_READER_PROPERTY_ID (webservices.h)

Identifie chaque propriété de lecteur XML et sa valeur associée. Cette énumération est utilisée dans la structure WS_XML_READER_PROPERTY , qui est utilisée comme paramètre pour WsCreateReader, WsSetInput, WsSetInputToBuffer et WsReadXmlBufferFromBytes. Il est également utilisé directement comme paramètre pour WsGetReaderProperty.

Syntax

typedef enum {
  WS_XML_READER_PROPERTY_MAX_DEPTH = 0,
  WS_XML_READER_PROPERTY_ALLOW_FRAGMENT = 1,
  WS_XML_READER_PROPERTY_MAX_ATTRIBUTES = 2,
  WS_XML_READER_PROPERTY_READ_DECLARATION = 3,
  WS_XML_READER_PROPERTY_CHARSET = 4,
  WS_XML_READER_PROPERTY_ROW = 5,
  WS_XML_READER_PROPERTY_COLUMN = 6,
  WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE = 7,
  WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE = 8,
  WS_XML_READER_PROPERTY_IN_ATTRIBUTE = 9,
  WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE = 10,
  WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE = 11,
  WS_XML_READER_PROPERTY_MAX_MIME_PARTS = 12,
  WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES = 13,
  WS_XML_READER_PROPERTY_MAX_NAMESPACES = 14
} WS_XML_READER_PROPERTY_ID;

Constantes

WS_XML_READER_PROPERTY_MAX_DEPTH Valeur : 0 ULONG qui spécifie la profondeur maximale du document que le lecteur autorise. La profondeur est mesurée à n’importe quel point par le nombre d’éléments de début imbriqués. Une profondeur de 0 empêche la lecture des éléments de début. Cette propriété est définie par défaut sur 32. Pour plus d’informations sur la sécurité, consultez WsCreateReader .
WS_XML_READER_PROPERTY_ALLOW_FRAGMENT Valeur : 1 Une boOL qui spécifie si le lecteur autorise plusieurs éléments et espaces non blancs au niveau supérieur du document. Cette propriété peut ne pas avoir la valeur TRUE avec WS_XML_READER_MTOM_ENCODING. Cette propriété a la valeur par défaut FALSE.
WS_XML_READER_PROPERTY_MAX_ATTRIBUTES Valeur : 2 ULONG qui spécifie le nombre maximal d’attributs que le lecteur autorise sur un élément. Cette propriété est définie par défaut sur 128. Pour plus d’informations sur la sécurité, consultez WsCreateReader .
WS_XML_READER_PROPERTY_READ_DECLARATION Valeur : 3 BoOL qui spécifie si le lecteur doit autoriser une déclaration xml au début du document. Cette propriété a la valeur par défaut TRUE.
WS_XML_READER_PROPERTY_CHARSET Valeur : 4 Valeur WS_CHARSET qui retourne le jeu de caractères du document xml. Cette valeur est disponible uniquement pour documents texte. Si le lecteur a été initialisé avec un WS_CHARSET_AUTO il détermine automatiquement ce Valeur. La source d’entrée du lecteur est diffusée, puis le lecteur doit avoir suffisamment de données mises en mémoire tampon pour pouvoir inspecter les marques d’ordre d’octet initiales et la déclaration xml. Consultez WsFillReader. Si le lecteur a été initialisé avec une autre valeur, cette propriété retourne simplement cette valeur.
WS_XML_READER_PROPERTY_ROW Valeur : 5 ULONGLONG qui retourne le numéro de ligne 0 du nœud sur lequel le lecteur est positionné pour les documents xml de texte.
WS_XML_READER_PROPERTY_COLUMN Valeur : 6 ULONGLONG qui retourne le numéro de colonne de base 0 du nœud sur lequel le lecteur est positionné pour les documents xml texte.
WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE Valeur : 7 ULONG qui spécifie la taille de découpage de la mémoire tampon interne utilisée par le WS_XML_READER pour effectuer des conversions UTF-16 en UTF-8. Augmentation de cette valeur utilise plus de mémoire, mais peut réduire les allocations lors du traitement des documents encodés en UTF-16. Cette propriété est définie par défaut sur 4096.
WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE Valeur : 8 ULONG qui spécifie la taille de la mémoire tampon que le WS_XML_READER utilisera lorsqu’il est configuré pour utiliser WS_XML_READER_STREAM_INPUT. L’augmentation de cette valeur utilise plus de mémoire, mais peut réduire le nombre de fois où le WS_READ_CALLBACK est appelé. Cette propriété est définie par défaut sur 4096.
WS_XML_READER_PROPERTY_IN_ATTRIBUTE Valeur : 9 Indique que WsReadStartAttribute a été appelé et que le lecteur est positionné sur le contenu de l’attribut.
WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE Valeur : 10 ULONG utilisé avec WS_XML_READER_STREAM_INPUT conjointement avec WS_XML_READER_MTOM_ENCODING. Cette valeur spécifie la taille maximale de la partie MIME racine, qui est la partie qui contient partie xml du document. Elle n’a aucun effet lorsqu’elle est utilisée avec d’autres encodages, ou lorsqu’elle est utilisée avec WS_XML_READER_BUFFER_INPUT. Cette propriété est définie par défaut sur 65536.
WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE Valeur : 11 ULONG utilisé avec WS_XML_READER_STREAM_INPUT conjointement avec WS_XML_READER_MTOM_ENCODING. Cette valeur spécifie la taille maximale de tout groupe d’en-têtes MIME pouvant apparaître dans le document. Elle n’a aucun effet lorsqu’elle est utilisée avec d’autres encodages ou lorsqu’elle est utilisée avec WS_XML_READER_BUFFER_INPUT. Cette propriété est définie par défaut sur 256.
WS_XML_READER_PROPERTY_MAX_MIME_PARTS Valeur : 12 ULONG utilisé avec WS_XML_READER_MTOM_ENCODING. Cette valeur spécifie le nombre maximal de parties MIME qui peut apparaître dans le document. Il n’a aucun effet lorsqu’il est utilisé avec d’autres encodages. Cette propriété est définie par défaut sur 4096.
WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES Valeur : 13 BoOL utilisé avec WS_XML_READER_TEXT_ENCODING. La définition de ce paramètre sur TRUE autorise les références de caractères de caractères considérés comme non valides par XML 1.0 pour être acceptés. La définition de cette propriété sur TRUE peut affecter l’interopérabilité. Cette propriété a la valeur par défaut FALSE.
WS_XML_READER_PROPERTY_MAX_NAMESPACES Valeur : 14 ULONG qui spécifie le nombre maximal de déclarations uniques xmlns pouvant apparaître dans l’étendue à tout moment lors de la lecture du document. Cette propriété est définie par défaut sur 32. Pour plus d’informations sur la sécurité, consultez WsCreateReader .

Configuration requise

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