Bagikan melalui


SqlDataReader.GetSchemaTable Metode

Definisi

Mengembalikan yang DataTable menjelaskan metadata kolom dari SqlDataReader.

public:
 virtual System::Data::DataTable ^ GetSchemaTable();
public:
 override System::Data::DataTable ^ GetSchemaTable();
public System.Data.DataTable GetSchemaTable ();
public override System.Data.DataTable GetSchemaTable ();
abstract member GetSchemaTable : unit -> System.Data.DataTable
override this.GetSchemaTable : unit -> System.Data.DataTable
override this.GetSchemaTable : unit -> System.Data.DataTable
Public Function GetSchemaTable () As DataTable
Public Overrides Function GetSchemaTable () As DataTable

Mengembalikan

DataTable yang menjelaskan metadata kolom.

Penerapan

Pengecualian

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 di 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 null.
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.

Berlaku untuk

Lihat juga