Metode OpenSchema

Mendapatkan informasi skema database dari penyedia.

Sintaks

  
Set recordset = connection.OpenSchema(QueryType, Criteria, SchemaID)  

Tampilkan Nilai

Mengembalikan objek Recordset yang berisi informasi skema. Recordset akan dibuka sebagai kursor statis baca-saja. QueryType menentukan kolom apa yang muncul di Recordset.

Parameter

QueryType
Nilai SchemaEnum apa pun yang mewakili jenis kueri skema yang akan dijalankan.

Kriteria
Pilihan. Array batasan kueri untuk setiap opsi QueryType , seperti yang tercantum dalam SchemaEnum.

SchemaID
GUID untuk kueri skema penyedia yang tidak ditentukan oleh spesifikasi OLE DB. Parameter ini diperlukan jika QueryType diatur ke adSchemaProviderSpecific; jika tidak, itu tidak digunakan.

Keterangan

Metode OpenSchema mengembalikan informasi deskriptif mandiri tentang sumber data, seperti tabel apa yang ada di sumber data, kolom dalam tabel, dan jenis data yang didukung.

Argumen QueryType adalah GUID yang menunjukkan kolom (skema) yang dikembalikan. Spesifikasi OLE DB memiliki daftar lengkap skema.

Argumen Kriteria membatasi hasil kueri skema. Kriteria menentukan array nilai yang harus terjadi dalam subset kolom yang sesuai, yang disebut kolom batasan, dalam Recordset yang dihasilkan.

AdSchemaProviderSpecific konstan digunakan untuk argumen QueryType jika penyedia menentukan kueri skema nonstandardnya sendiri di luar yang tercantum sebelumnya. Ketika konstanta ini digunakan, argumen SchemaID diperlukan untuk meneruskan GUID kueri skema untuk dijalankan. Jika QueryType diatur ke adSchemaProviderSpecific tetapi SchemaID tidak disediakan, kesalahan akan terjadi.

Penyedia tidak diperlukan untuk mendukung semua kueri skema standar OLE DB. Secara khusus, hanya adSchemaTables, adSchemaColumns, dan adSchemaProviderTypes yang diperlukan oleh spesifikasi OLE DB. Namun, penyedia tidak diperlukan untuk mendukung batasan Kriteria yang tercantum sebelumnya untuk kueri skema tersebut.

Catatan

Penggunaan Layanan Data Jarak Jauh Metode OpenSchema tidak tersedia pada objek Koneksi sisi klien.

Catatan

Di Visual Basic, kolom yang memiliki bilangan bulat tanpa tanda empat byte (DBTYPE UI4) di Recordset yang dikembalikan dari metode OpenSchema pada objek Koneksi tidak dapat dibandingkan dengan variabel lain. Untuk informasi selengkapnya tentang jenis data OLE DB, lihat Tipe Data di OLE DB (OLE DB) dan Lampiran A: Jenis Data di Referensi Programmer Microsoft OLE DB.

Catatan

Pengguna Visual C/C++ Saat tidak menggunakan kursor sisi klien, mengambil "ORDINAL_POSITION" skema kolom di ADO mengembalikan varian jenis VT_R8 di MDAC 2.7, MDAC 2.8, dan Windows Data Access Components (Windows DAC) 6.0, sementara jenis yang digunakan dalam MDAC 2.6 VT_I4. Program yang ditulis untuk MDAC 2.6 yang hanya mencari varian yang dikembalikan dari jenis VT_I4 akan mendapatkan nol untuk setiap ordinal jika dijalankan di bawah MDAC 2.7, MDAC 2.8, dan Windows DAC 6.0 tanpa modifikasi. Perubahan ini dilakukan karena tipe data yang dikembalikan OLE DB DBTYPE_UI4, dan dalam jenis VT_I4 yang ditandatangani tidak ada cukup ruang untuk memuat semua nilai yang mungkin tanpa mungkin terjadi pemotongan dan sehingga menyebabkan hilangnya data.

Berlaku Untuk

Objek Koneksi (ADO)

Lihat juga

Contoh Metode OpenSchema (Visual Basic)
Contoh Metode OpenSchema (VC++)
Metode Terbuka (Koneksi ADO)
Metode Terbuka (Catatan ADO)
Metode Terbuka (Recordset ADO)
Metode Terbuka (Aliran ADO)
Lampiran A: Penyedia