Condividi tramite


enumerazione WS_XML_READER_PROPERTY_ID (webservices.h)

Identifica ogni proprietà di lettura XML e il relativo valore associato. Questa enumerazione viene usata all'interno della struttura WS_XML_READER_PROPERTY , utilizzata come parametro per WsCreateReader, WsSetInput, WsSetInputToBuffer e WsReadXmlBufferFromBytes. Viene usato direttamente come parametro per WsGetReaderProperty.

Sintassi

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;

Costanti

 
WS_XML_READER_PROPERTY_MAX_DEPTH
Valore: 0
ULONG che specifica la profondità massima del documento consentito dal lettore.


La profondità viene misurata in qualsiasi punto in base al numero di elementi iniziali annidati.


Una profondità di 0 impedisce la lettura di elementi iniziali.


Questa proprietà viene impostata su 32.


Per considerazioni sulla sicurezza, vedere WsCreateReader .
WS_XML_READER_PROPERTY_ALLOW_FRAGMENT
Valore: 1
Valore BOOL che
specifica se il lettore consentirà più elementi e spazi non vuoti a livello superiore del documento. Questa proprietà
potrebbe non essere impostato su TRUE con WS_XML_READER_MTOM_ENCODING.


Questa proprietà viene predefinita su FALSE.
WS_XML_READER_PROPERTY_MAX_ATTRIBUTES
Valore: 2
ULONG che specifica il numero massimo di attributi consentiti dal lettore in un elemento.


Questa proprietà viene impostata su 128.


Per considerazioni sulla sicurezza, vedere WsCreateReader .
WS_XML_READER_PROPERTY_READ_DECLARATION
Valore: 3
Valore BOOL che specifica se il lettore deve consentire una dichiarazione xml all'inizio del documento.


Questa proprietà è impostata su TRUE.
WS_XML_READER_PROPERTY_CHARSET
Valore: 4
Valore WS_CHARSET che restituisce il set di caratteri del documento xml. Questo valore è disponibile solo per
documenti di testo.


Se il lettore è stato inizializzato con un WS_CHARSET_AUTO , determina automaticamente questo
Valore. L'origine di input lettore è in streaming, quindi il lettore deve avere un buffer di dati sufficiente per poter essere in grado di
esaminare i contrassegni di ordine di byte iniziali e la dichiarazione xml. Vedere WsFillReader.


Se il lettore è stato inizializzato con qualsiasi altro valore, questa proprietà restituisce semplicemente tale valore.
WS_XML_READER_PROPERTY_ROW
Valore: 5
ULONGLONG che restituisce il numero di riga basato su 0 del nodo in cui viene posizionato il lettore per i documenti xml di testo.
WS_XML_READER_PROPERTY_COLUMN
Valore: 6
ULONGLONG che restituisce il numero di colonna basato su 0 del nodo in cui viene posizionato il lettore per i documenti xml di testo.
WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE
Valore: 7
ULONG che specifica le dimensioni di taglio del buffer interno utilizzato dall'oggetto
WS_XML_READER per eseguire conversioni UTF-16 a UTF-8. Aumento di questo valore
usa più memoria, ma può ridurre le allocazioni durante l'elaborazione di documenti codificati UTF-16.


Questa proprietà viene impostata su 4096.
WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE
Valore: 8
ULONG che specifica le dimensioni del buffer che il WS_XML_READER userà quando configurato per l'uso
WS_XML_READER_STREAM_INPUT. L'aumento di questo valore usa più memoria, ma
può ridurre il numero di volte in cui viene richiamata la WS_READ_CALLBACK .


Questa proprietà viene impostata su 4096.
WS_XML_READER_PROPERTY_IN_ATTRIBUTE
Valore: 9
Indica che WsReadStartAttribute è stato chiamato e il lettore è
posizionato sul contenuto dell'attributo.
WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE
Valore: 10
ULONG usato con WS_XML_READER_STREAM_INPUT insieme a WS_XML_READER_MTOM_ENCODING.
Questo valore specifica le dimensioni massime della parte MIME radice, ovvero la parte che contiene
parte xml del documento. Non ha alcun effetto quando viene usato con altre codifiche o quando usato con
WS_XML_READER_BUFFER_INPUT.


Questa proprietà viene impostata su 65536.
WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE
Valore: 11
ULONG usato con WS_XML_READER_STREAM_INPUT insieme a WS_XML_READER_MTOM_ENCODING.
Questo valore specifica la dimensione massima di qualsiasi gruppo di intestazioni MIME che possono essere visualizzate nel documento.
Non ha alcun effetto quando viene usato con altre codifiche o quando usato con WS_XML_READER_BUFFER_INPUT.


Questa proprietà viene impostata su 256.
WS_XML_READER_PROPERTY_MAX_MIME_PARTS
Valore: 12
ULONG usato con WS_XML_READER_MTOM_ENCODING. Questo valore specifica il numero massimo di parti MIME
che può essere visualizzato nel documento. Non ha alcun effetto quando viene usato con altre codifiche.


Questa proprietà viene impostata su 4096.
WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES
Valore: 13
Valore BOOL usato con WS_XML_READER_TEXT_ENCODING. L'impostazione di questa opzione su TRUE consente riferimenti ai caratteri
di caratteri considerati non validi da XML 1.0 da accettare.


L'impostazione di questa proprietà su TRUE può influire sull'interoperabilità.


Questa proprietà viene predefinita su FALSE.
WS_XML_READER_PROPERTY_MAX_NAMESPACES
Valore: 14
ULONG che specifica il numero massimo di dichiarazioni univoche xmlns che possono essere visualizzate nell'ambito in qualsiasi punto
durante la lettura del documento.


Questa proprietà viene impostata su 32.


Per considerazioni sulla sicurezza, vedere WsCreateReader .

Requisiti

   
Client minimo supportato Windows 7 [app desktop | App UWP]
Server minimo supportato Windows Server 2008 R2 [app desktop | App UWP]
Intestazione webservices.h