XmlReadMode Enum

Definisi

Menentukan cara membaca data XML dan skema relasional ke dalam DataSet.

public enum class XmlReadMode
public enum XmlReadMode
type XmlReadMode = 
Public Enum XmlReadMode
Warisan
XmlReadMode

Bidang

Auto 0

Mode baca default.

DiffGram 4

Membaca DiffGram, menerapkan perubahan dari DiffGram ke DataSet. Semantik identik dengan Merge(DataSet) operasi. Seperti halnya Merge(DataSet) operasi, RowState nilai dipertahankan. Input ke ReadXml(XmlReader) dengan DiffGram hanya boleh diperoleh menggunakan output dari WriteXml(Stream) sebagai DiffGram.

Target DataSet harus memiliki skema yang sama dengan DataSet di mana WriteXml DiffGram dipanggil. Jika tidak, operasi penggabungan DiffGram gagal dan pengecualian dilemparkan.

Fragment 5

Membaca fragmen XML, seperti yang dihasilkan dengan mengeksekusi kueri XML, terhadap instans SQL Server. Ketika XmlReadMode diatur ke Fragment, namespace default dibaca sebagai skema sebaris.

IgnoreSchema 2

Mengabaikan skema sebaris apa pun dan membaca data ke dalam skema DataSet yang ada. Jika ada data yang tidak cocok dengan skema yang ada, data akan dibuang (termasuk data dari namespace yang berbeda yang ditentukan untuk DataSet). Jika data adalah DiffGram, IgnoreSchema memiliki fungsionalitas yang sama dengan DiffGram.

InferSchema 3

Mengabaikan skema sebaris, menyimpulkan skema dari data dan memuat data. DataSet Jika sudah berisi skema, skema saat ini diperluas dengan menambahkan tabel baru atau menambahkan kolom ke tabel yang sudah ada. Pengecualian dilemparkan jika tabel yang disimpulkan sudah ada tetapi dengan namespace layanan yang berbeda, atau jika salah satu kolom yang disimpulkan bertentangan dengan kolom yang ada.

InferTypedSchema 6

Mengabaikan skema sebaris apa pun, menyimpulkan skema yang sangat diketik dari data, dan memuat data. Jika jenis tidak dapat disimpulkan dari data, jenis tersebut ditafsirkan sebagai data string. DataSet Jika sudah berisi skema, skema saat ini diperluas, baik dengan menambahkan tabel baru atau dengan menambahkan kolom ke tabel yang sudah ada. Pengecualian dilemparkan jika tabel yang disimpulkan sudah ada tetapi dengan namespace layanan yang berbeda, atau jika salah satu kolom yang disimpulkan bertentangan dengan kolom yang ada.

ReadSchema 1

Membaca skema sebaris dan memuat data. DataSet Jika sudah berisi skema, tabel baru dapat ditambahkan ke skema, tetapi pengecualian dilemparkan jika ada tabel dalam skema sebaris yang sudah ada di DataSet.

Keterangan

Gunakan anggota enumerasi ini saat mengatur ReadMode parameter DataSet.ReadXml metode .

Catatan

Auto mode mungkin lebih lambat daripada pengaturan XmlReadMode ke opsi eksplisit.

Auto melakukan tindakan yang paling tepat dari tindakan ini:

  • Jika data adalah DiffGram, atur mode baca XML ke DiffGram.

  • Jika himpunan data sudah memiliki skema, atau jika dokumen berisi skema dalam baris, atur mode baca XML ke ReadSchema.

  • Jika himpunan data belum memiliki skema dan dokumen tidak berisi skema dalam baris, atur mode baca XML ke InferSchema.

Berlaku untuk