enumerasi WS_XML_READER_PROPERTY_ID (webservices.h)
Mengidentifikasi setiap properti pembaca XML adalah dan nilai terkaitnya. Enumerasi ini digunakan dalam struktur WS_XML_READER_PROPERTY , yang digunakan sebagai parameter untuk WsCreateReader, WsSetInput, WsSetInputToBuffer, dan WsReadXmlBufferFromBytes. Ini juga digunakan langsung sebagai parameter untuk WsGetReaderProperty.
Sintaks
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;
Konstanta
WS_XML_READER_PROPERTY_MAX_DEPTH Nilai: 0 ULONG yang menentukan kedalaman maksimum dokumen yang akan diizinkan pembaca. Kedalaman diukur kapan saja dengan jumlah elemen mulai berlapis. Kedalaman 0 mencegah elemen awal dibaca. Properti ini default ke 32. Lihat WsCreateReader untuk pertimbangan keamanan. |
WS_XML_READER_PROPERTY_ALLOW_FRAGMENT Nilai: 1 BOOL yang menentukan apakah pembaca akan mengizinkan beberapa elemen dan ruang non-putih di tingkat atas dokumen. Properti ini mungkin tidak diatur ke TRUE dengan WS_XML_READER_MTOM_ENCODING. Properti ini default ke FALSE. |
WS_XML_READER_PROPERTY_MAX_ATTRIBUTES Nilai: 2 ULONG yang menentukan jumlah maksimum atribut yang akan diizinkan pembaca pada elemen. Properti ini default ke 128. Lihat WsCreateReader untuk pertimbangan keamanan. |
WS_XML_READER_PROPERTY_READ_DECLARATION Nilai: 3 BOOL yang menentukan apakah pembaca harus mengizinkan deklarasi xml di awal dokumen. Properti ini default ke TRUE. |
WS_XML_READER_PROPERTY_CHARSET Nilai: 4 Nilai WS_CHARSET yang mengembalikan kumpulan karakter dokumen xml. Nilai ini hanya tersedia untuk dokumen teks. Jika pembaca diinisialisasi dengan WS_CHARSET_AUTO maka akan secara otomatis menentukan ini Nilai. Sumber input pembaca dialirkan, maka pembaca harus memiliki cukup data yang di-buffer agar dapat periksa tanda urutan byte awal dan deklarasi xml. Lihat WsFillReader. Jika pembaca diinisialisasi dengan nilai lain, maka properti ini hanya mengembalikan nilai tersebut. |
WS_XML_READER_PROPERTY_ROW Nilai: 5 ULONGLONG yang mengembalikan nomor baris berbasis 0 dari simpul yang diposisikan pembaca untuk dokumen xml teks. |
WS_XML_READER_PROPERTY_COLUMN Nilai: 6 ULONGLONG yang mengembalikan nomor kolom berbasis 0 dari simpul yang diposisikan pembaca untuk dokumen xml teks. |
WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE Nilai: 7 ULONG yang menentukan ukuran pemangkasan buffer internal yang digunakan oleh WS_XML_READER untuk melakukan konversi UTF-16 ke UTF-8. Meningkatkan nilai ini menggunakan lebih banyak memori, tetapi dapat mengurangi alokasi saat memproses dokumen yang dikodekan UTF-16. Properti ini default ke 4096. |
WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE Nilai: 8 ULONG yang menentukan ukuran buffer yang akan digunakan WS_XML_READER saat dikonfigurasi untuk digunakan WS_XML_READER_STREAM_INPUT. Meningkatkan nilai ini menggunakan lebih banyak memori, tetapi dapat mengurangi berapa kali WS_READ_CALLBACK dipanggil. Properti ini default ke 4096. |
WS_XML_READER_PROPERTY_IN_ATTRIBUTE Nilai: 9 Menunjukkan bahwa WsReadStartAttribute telah dipanggil dan pembaca diposisikan pada konten atribut. |
WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE Nilai: 10 ULONG yang digunakan dengan WS_XML_READER_STREAM_INPUT bersama dengan WS_XML_READER_MTOM_ENCODING. Nilai ini menentukan ukuran maksimum bagian MIME akar, yang merupakan bagian yang berisi bagian xml dokumen. Ini tidak berpengaruh ketika digunakan dengan pengodean lain, atau ketika digunakan dengan WS_XML_READER_BUFFER_INPUT. Properti ini default ke 65536. |
WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE Nilai: 11 ULONG yang digunakan dengan WS_XML_READER_STREAM_INPUT bersama dengan WS_XML_READER_MTOM_ENCODING. Nilai ini menentukan ukuran maksimum grup header MIME apa pun yang mungkin muncul dalam dokumen. Ini tidak berpengaruh ketika digunakan dengan pengodean lain, atau ketika digunakan dengan WS_XML_READER_BUFFER_INPUT. Properti ini default ke 256. |
WS_XML_READER_PROPERTY_MAX_MIME_PARTS Nilai: 12 ULONG yang digunakan dengan WS_XML_READER_MTOM_ENCODING. Nilai ini menentukan jumlah maksimum bagian MIME yang mungkin muncul dalam dokumen. Ini tidak berpengaruh ketika digunakan dengan pengodean lain. Properti ini default ke 4096. |
WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES Nilai: 13 BOOL yang digunakan dengan WS_XML_READER_TEXT_ENCODING. Mengatur ini ke TRUE mengizinkan referensi karakter karakter yang dianggap tidak valid oleh XML 1.0 untuk diterima. Mengatur properti ini ke TRUE dapat memengaruhi interoperabilitas. Properti ini default ke FALSE. |
WS_XML_READER_PROPERTY_MAX_NAMESPACES Nilai: 14 ULONG yang menentukan jumlah maksimum deklarasi unik xmln yang mungkin muncul dalam cakupan kapan saja saat membaca dokumen. Properti ini default ke 32. Lihat WsCreateReader untuk pertimbangan keamanan. |
Persyaratan
Klien minimum yang didukung | Windows 7 [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP] |
Header | webservices.h |