Partager via

énumération WS_XML_READER_PROPERTY_ID (webservices.h)

  • Article

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