SqlDataReader.GetSchemaTable Metode

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Mengembalikan yang DataTable menjelaskan metadata kolom dari SqlDataReader.

public:
 override System::Data::DataTable ^ GetSchemaTable();

public override System.Data.DataTable GetSchemaTable ();

override this.GetSchemaTable : unit -> System.Data.DataTable

Public Overrides Function GetSchemaTable () As DataTable

Mengembalikan

DataTable

DataTable yang menjelaskan metadata kolom.

Penerapan

GetSchemaTable()

Pengecualian

InvalidOperationException

Sudah SqlDataReader ditutup.

Keterangan

Metode mengembalikan GetSchemaTable metadata berikut tentang setiap kolom:

Kolom DataReader	Deskripsi
AllowDBNull	Atur apakah konsumen dapat mengatur kolom ke nilai null atau jika penyedia tidak dapat menentukan apakah konsumen dapat mengatur kolom ke nilai null. Jika tidak, tidak diatur. Kolom mungkin berisi nilai null, meskipun tidak dapat diatur ke nilai null.
BaseCatalogName	Nama katalog di penyimpanan data yang berisi kolom . NULL jika nama katalog dasar tidak dapat ditentukan. Default kolom ini adalah nilai null.
BaseColumnName	Nama kolom di penyimpanan data. Ini mungkin berbeda dari nama kolom yang dikembalikan di kolom ColumnName jika alias digunakan. Nilai null jika nama kolom dasar tidak dapat ditentukan atau jika kolom set baris diturunkan, tetapi tidak identik dengan, kolom di penyimpanan data. Default kolom ini adalah nilai null.
BaseSchemaName	Nama skema di penyimpanan data yang berisi kolom . Nilai null jika nama skema dasar tidak dapat ditentukan. Default kolom ini adalah nilai null.
BaseServerName	Nama instans Microsoft SQL Server digunakan oleh SqlDataReader.
BaseTableName	Nama tabel atau tampilan di penyimpanan data yang berisi kolom. Nilai null jika nama tabel dasar tidak dapat ditentukan. Default kolom ini adalah nilai null.
ColumnName	Nama kolom; ini mungkin tidak unik. Jika ini tidak dapat ditentukan, nilai null dikembalikan. Nama ini selalu mencerminkan penggantian nama kolom terbaru dalam tampilan atau teks perintah saat ini.
ColumnOrdinal	Ordinal kolom berbasis nol. Kolom ini tidak boleh berisi nilai kosong.
ColumnSize	Panjang maksimum nilai yang mungkin dalam kolom. Untuk kolom yang menggunakan jenis data dengan panjang tetap, ini adalah ukuran jenis data. Untuk nvarchar(MAX)kolom , varchar(MAX), dan varbinary(MAX) yang disimpan dalam database SQL Server, ukuran maksimumnya adalah 2GB. Jika kolom ini disimpan dan diakses sebagai file, batas ukuran maksimum diberlakukan oleh sistem file. Nilai ini berubah saat menggunakan Type System Version kata kunci dalam string koneksi. Untuk jenis baru, mereka direpresentasikan sebagai jenis downlevel. Jenis data MAX mengembalikan 4k normal untuk nvarchar dan 8000 untuk varchar. Untuk informasi selengkapnya, lihat referensi Transact-SQL.
DataTypeName	Mengembalikan string yang mewakili jenis data kolom yang ditentukan.
IsAliased	true: Nama kolom adalah alias. false: Nama kolom bukan alias.
IsAutoIncrement	true: Kolom menetapkan nilai ke baris baru dalam kenaikan tetap. false: Kolom tidak menetapkan nilai ke baris baru dalam kenaikan tetap. Default kolom ini adalah false.
IsColumnSet	true: Kolom adalah kolom jarang yang merupakan anggota kumpulan kolom.
IsExpression	true: Kolom adalah ekspresi. false: Kolom bukan ekspresi.
IsHidden	true: Kolom disembunyikan. false: Kolom tidak disembunyikan.
IsIdentitas	true: Kolom adalah kolom identitas. false: Kolom bukan kolom identitas.
IsKey	true: Kolom adalah salah satu dari sekumpulan kolom dalam set baris yang, disatukan, secara unik mengidentifikasi baris. Kumpulan kolom dengan IsKey diatur ke true harus mengidentifikasi baris secara unik dalam set baris. Tidak ada persyaratan bahwa kumpulan kolom ini adalah sekumpulan kolom minimal. Kumpulan kolom ini dapat dihasilkan dari kunci primer tabel dasar, batasan unik, atau indeks unik. false: Kolom tidak diperlukan untuk mengidentifikasi baris secara unik.
IsLong	true: Kolom berisi Objek Panjang Biner (BLOB) yang berisi data yang sangat panjang. Definisi data yang sangat panjang khusus untuk penyedia. false: Kolom tidak berisi Objek Panjang Biner (BLOB) yang berisi data yang sangat panjang.
IsReadOnly	true: Kolom tidak dapat dimodifikasi. false: Kolom dapat dimodifikasi.
IsRowVersion	true: Kolom berisi pengidentifikasi baris persisten yang tidak dapat ditulis, dan tidak memiliki nilai yang bermakna kecuali untuk mengidentifikasi baris. false: Kolom tidak berisi pengidentifikasi baris persisten yang tidak dapat ditulis, dan tidak memiliki nilai yang bermakna kecuali untuk mengidentifikasi baris.
IsUnique	true: Kolom berjenis timestamp. false: Kolom tidak berjenis timestamp.
NonVersionedProviderType	Jenis kolom terlepas dari saat ini Type System Version yang ditentukan dalam string koneksi. Nilai yang dikembalikan berasal dari SqlDbType enumerasi.
NumericPrecision	Jika ProviderType adalah jenis data numerik, ini adalah presisi maksimum kolom. Presisi tergantung pada definisi kolom. Jika ProviderType bukan jenis data numerik, ini adalah 255.
NumericScale	Jika ProviderType DBTYPE_DECIMAL atau DBTYPE_NUMERIC, jumlah digit di sebelah kanan titik desimal. Jika tidak, ini adalah 255.
ProviderSpecificDataType	Mengembalikan jenis data khusus penyedia kolom berdasarkan Type System Version kata kunci dalam string koneksi.
ProviderType	Indikator jenis data kolom. Jika jenis data kolom bervariasi dari baris ke baris, ini harus Objek. Kolom ini tidak boleh berisi nilai kosong.
UdtAssemblyQualifiedName	Jika kolom adalah jenis yang ditentukan pengguna (UDT), ini adalah nama yang memenuhi syarat dari perakitan UDT sesuai AssemblyQualifiedName. Jika kolom bukan UDT, ini null.
XmlSchemaCollectionDatabase	Nama database tempat kumpulan skema untuk instans XML ini berada, jika baris berisi informasi tentang kolom XML. Nilai ini adalah null (Nothing dalam Visual Basic) jika koleksi ditentukan dalam database saat ini. Ini juga null jika tidak ada koleksi skema, dalam hal ini XmlSchemaCollectionName kolom dan XmlSchemaCollectionOwningSchema juga null.
XmlSchemaCollectionName	Nama kumpulan skema untuk instans XML ini, jika baris berisi informasi tentang kolom XML. Nilai ini adalah null (Nothing dalam Visual Basic) jika tidak ada koleksi skema terkait. Jika nilainya null, XmlSchemaCollectionDatabase kolom dan XmlSchemaCollectionOwningSchema juga null.
XmlSchemaCollectionOwningSchema	Skema relasional pemilik tempat kumpulan skema untuk instans XML ini berada, jika baris berisi informasi tentang kolom XML. Nilai ini adalah null (Nothing dalam Visual Basic) jika koleksi ditentukan dalam database saat ini. Ini juga null jika tidak ada koleksi skema, dalam hal ini XmlSchemaCollectionDatabase kolom dan XmlSchemaCollectionName juga null.

Catatan

Untuk memastikan bahwa kolom metadata mengembalikan informasi yang benar, Anda harus memanggil ExecuteReader dengan parameter yang behavior diatur ke KeyInfo. Jika tidak, beberapa kolom dalam tabel skema dapat mengembalikan data default, null, atau salah.