Metode OpenSchema

Mendapatkan informasi skema database dari penyedia.

Sintaksis

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

Mengembalikan 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
Setiap nilai SchemaEnum yang mewakili jenis kueri skema yang akan dijalankan.

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

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

Komentar

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.

Konstanta adSchemaProviderSpecific digunakan untuk argumen QueryType jika penyedia mendefinisikan kueri skema nonstandarnya 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 diperlukan oleh spesifikasi OLE DB. Namun, penyedia tidak diperlukan untuk mendukung batasan Kriteria yang tercantum sebelumnya untuk kueri skema tersebut.

Nota

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

Nota

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

Nota

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 pemotongan terjadi dan dengan demikian menyebabkan hilangnya data.

Berlaku Untuk

Objek Koneksi (ADO)

Lihat Juga

Contoh Metode OpenSchema (VB)
Contoh Metode OpenSchema (VC++)
Metode Terbuka (Koneksi ADO)
Metode Terbuka (Catatan ADO)
Metode Terbuka (ADO Recordset)
Open Method (ADO Stream)
Lampiran A: Penyedia