XmlReadMode Enum

Definisi

Ruang nama:

System.Data

Rakitan:

System.Data.dll

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

public enum class XmlReadMode

public enum XmlReadMode

type XmlReadMode = 

Public Enum XmlReadMode

Warisan

Object

ValueType

Enum

XmlReadMode

Bidang

Nama	Nilai	Deskripsi
Auto	0	Mode baca default.
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.
IgnoreSchema	2	Mengabaikan skema sebaris dan membaca data ke dalam skema yang DataSet ada. Jika ada data yang tidak cocok dengan skema yang ada, data tersebut 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 apa pun, 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 yang berbeda, atau jika salah satu kolom yang disimpulkan bertentangan dengan kolom yang ada.
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 DiffGrams 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 menjalankan kueri XML FOR, terhadap instans SQL Server. Ketika XmlReadMode diatur ke Fragment, namespace default dibaca sebagai skema sebaris.
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 yang berbeda, atau jika salah satu kolom yang disimpulkan bertentangan dengan kolom yang ada.

Keterangan

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

Note

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

Auto melakukan tindakan ini yang paling tepat:

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

• Jika himpunan data sudah memiliki skema, atau jika dokumen berisi skema sebaris, 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.