WS_XML_READER_PROPERTY_ID-Enumeration (webservices.h)

  • Artikel

Gibt jede XML-Readereigenschaft und ihren zugeordneten Wert an. Diese Enumeration wird innerhalb der WS_XML_READER_PROPERTY-Struktur verwendet, die als Parameter für WsCreateReader, WsSetInput, WsSetInputToBuffer und WsReadXmlBufferFromBytes verwendet wird. Es wird auch direkt als Parameter für WsGetReaderProperty verwendet.

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;

Konstanten

 
WS_XML_READER_PROPERTY_MAX_DEPTH
Wert: 0
Eine ULONG , die die maximale Tiefe des Dokuments angibt, die der Leser zulassen soll.


Die Tiefe wird an einem beliebigen Punkt durch die Anzahl der geschachtelten Startelemente gemessen.


Eine Tiefe von 0 verhindert, dass Startelemente gelesen werden.


Diese Eigenschaft ist standardmäßig auf 32 festgelegt.


Sicherheitsüberlegungen finden Sie unter WsCreateReader .
WS_XML_READER_PROPERTY_ALLOW_FRAGMENT
Wert: 1
Ein BOOL , das
gibt an, ob der Reader mehrere Elemente und Nicht-Leerzeichen auf der obersten Ebene des Dokuments zulässt. Diese Eigenschaft
kann mit WS_XML_READER_MTOM_ENCODING nicht auf TRUE festgelegt werden.


Diese Eigenschaft ist standardmäßig FALSE.
WS_XML_READER_PROPERTY_MAX_ATTRIBUTES
Wert: 2
Eine ULONG , die die maximale Anzahl von Attributen angibt, die der Leser für ein Element zulassen wird.


Diese Eigenschaft ist standardmäßig auf 128 festgelegt.


Sicherheitsüberlegungen finden Sie unter WsCreateReader .
WS_XML_READER_PROPERTY_READ_DECLARATION
Wert: 3
Ein BOOL , der angibt, ob der Reader am Anfang des Dokuments eine XML-Deklaration zulassen soll.


Diese Eigenschaft ist standardmäßig auf TRUE festgelegt.
WS_XML_READER_PROPERTY_CHARSET
Wert: 4
Ein WS_CHARSET Wert, der den Zeichensatz des XML-Dokuments zurückgibt. Dieser Wert ist nur für
Textdokumente.


Wenn der Reader mit einem WS_CHARSET_AUTO initialisiert wurde, wird dies automatisch ermittelt.
-Wert verwendet wird. Die Leseeingabequelle wird gestreamt, dann muss der Reader über genügend Datenpuffer verfügen, um in der Lage zu sein,
untersuchen Sie die anfänglichen Bytereihenfolgen und die XML-Deklaration. Siehe WsFillReader.


Wenn der Reader mit einem anderen Wert initialisiert wurde, gibt diese Eigenschaft einfach diesen Wert zurück.
WS_XML_READER_PROPERTY_ROW
Wert: 5
Eine ULONGLONG, die die 0-basierte Zeilennummer des Knotens zurückgibt, auf dem der Reader für XML-Textdokumente positioniert ist.
WS_XML_READER_PROPERTY_COLUMN
Wert: 6
Eine ULONGLONG, die die 0-basierte Spaltennummer des Knotens zurückgibt, auf dem der Reader für XML-Textdokumente positioniert ist.
WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE
Wert: 7
Eine ULONG , die die Kürzungsgröße des internen Puffers angibt, der vom
WS_XML_READER zum Ausführen von UTF-16-in-UTF-8-Konvertierungen. Erhöhen dieses Werts
verwendet mehr Arbeitsspeicher, kann jedoch die Zuordnungen bei der Verarbeitung von UTF-16-codierten Dokumenten reduzieren.


Diese Eigenschaft ist standardmäßig 4096.
WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE
Wert: 8
Eine ULONG , die die Größe des Puffers angibt, den der WS_XML_READER bei der Konfiguration für die Verwendung verwendet.
WS_XML_READER_STREAM_INPUT. Das Erhöhen dieses Werts benötigt mehr Arbeitsspeicher, aber
kann die Anzahl der Aufrufe des WS_READ_CALLBACK verringern.


Diese Eigenschaft ist standardmäßig 4096.
WS_XML_READER_PROPERTY_IN_ATTRIBUTE
Wert: 9
Gibt an, dass WsReadStartAttribute aufgerufen wurde und der Reader
Positioniert auf Attributinhalt.
WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE
Wert: 10
Eine ULONG, die mit WS_XML_READER_STREAM_INPUT in Verbindung mit WS_XML_READER_MTOM_ENCODING verwendet wird.
Dieser Wert gibt die maximale Größe des MIME-Stammteils an, der den Teil enthält.
der XML-Teil des Dokuments. Bei Verwendung mit anderen Codierungen oder bei Verwendung mit
WS_XML_READER_BUFFER_INPUT.


Diese Eigenschaft ist standardmäßig 65536.
WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE
Wert: 11
Eine ULONG, die mit WS_XML_READER_STREAM_INPUT in Verbindung mit WS_XML_READER_MTOM_ENCODING verwendet wird.
Dieser Wert gibt die maximale Größe einer Gruppe von MIME-Headern an, die im Dokument angezeigt werden können.
Es hat keine Auswirkung, wenn es mit anderen Codierungen verwendet wird oder wenn es mit WS_XML_READER_BUFFER_INPUT verwendet wird.


Diese Eigenschaft ist standardmäßig 256.
WS_XML_READER_PROPERTY_MAX_MIME_PARTS
Wert: 12
Eine ULONG, die mit WS_XML_READER_MTOM_ENCODING verwendet wird. Dieser Wert gibt die maximale Anzahl von MIME-Teilen an.
die im Dokument angezeigt werden kann. Es hat keine Auswirkung, wenn es mit anderen Codierungen verwendet wird.


Diese Eigenschaft ist standardmäßig 4096.
WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES
Wert: 13
Eine BOOL , die mit WS_XML_READER_TEXT_ENCODING verwendet wird. Wenn Sie dies auf TRUE festlegen, werden Zeichenverweise zugelassen.
von Zeichen, die von XML 1.0 als ungültig betrachtet werden, um akzeptiert zu werden.


Das Festlegen dieser Eigenschaft auf TRUE kann sich auf die Interoperabilität auswirken.


Diese Eigenschaft ist standardmäßig FALSE.
WS_XML_READER_PROPERTY_MAX_NAMESPACES
Wert: 14
Eine ULONG , die die maximale Anzahl eindeutiger xmlns-Deklarationen angibt, die jederzeit im Bereich angezeigt werden können.
beim Lesen des Dokuments.


Diese Eigenschaft ist standardmäßig auf 32 festgelegt.


Sicherheitsüberlegungen finden Sie unter WsCreateReader .

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Kopfzeile webservices.h