enumerasi WS_XML_READER_PROPERTY_ID (webservices.h)

  • Artikel

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