XmlReadMode Enum
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menentukan cara membaca data XML dan skema relasional ke dalam DataSet.
public enum class XmlReadMode
public enum XmlReadMode
type XmlReadMode =
Public Enum XmlReadMode
- Warisan
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 |
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, |
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
.