Bagikan melalui

Wizard Konsumen ATL OLE DB

  • Artikel

Panduan ini tidak tersedia di Visual Studio 2019 dan yang lebih baru.

Panduan ini menyiapkan kelas konsumen OLE DB dengan pengikatan data yang diperlukan untuk mengakses sumber data yang ditentukan melalui penyedia OLE DB yang ditentukan.

Catatan

Panduan ini mengharuskan Anda mengklik tombol Sumber Data untuk memilih sumber data sebelum memasukkan nama di Class bidang file dan .h.

Daftar UIElement

  • Sumber data

    Tombol Sumber Data memungkinkan Anda menyiapkan sumber data yang ditentukan menggunakan penyedia OLE DB yang ditentukan. Saat Anda mengklik tombol ini, kotak dialog Properti Tautan Data muncul. Untuk informasi selengkapnya tentang membangun string koneksi dan kotak dialog Properti Tautan Data, lihat Gambaran Umum API Tautan Data di dokumentasi Windows SDK.

    Informasi tambahan berikut ini menjelaskan tab dalam kotak dialog Properti Tautan Data.

    • Tab Penyedia

      Pilih penyedia yang sesuai untuk mengelola koneksi ke sumber data. Jenis penyedia biasanya ditentukan oleh jenis database yang Anda sambungkan. Klik tombol Berikutnya atau klik tab Koneksi .

    • Tab Koneksi

      Isi tab ini bergantung pada penyedia yang Anda pilih. Meskipun ada banyak jenis penyedia, bagian ini mencakup koneksi untuk dua yang paling umum: data SQL dan ODBC. Yang lain adalah variasi serupa pada bidang yang dijelaskan di sini.

      Untuk data SQL:

      1. Pilih atau masukkan nama server: Klik menu daftar drop-down untuk menampilkan semua server data terdaftar di jaringan, dan pilih salah satu.

      2. Masukkan informasi untuk masuk ke server: Masukkan nama pengguna dan kata sandi untuk masuk ke server data.

        Catatan

        Ada masalah keamanan dengan fitur "Izinkan penyimpanan kata sandi" dari kotak dialog Properti Tautan Data. Di "Masukkan informasi untuk masuk ke server," ada dua tombol radio:

        • Menggunakan keamanan terintegrasi Windows NT
        • Menggunakan nama pengguna dan kata sandi tertentu

        Jika Anda memilih Gunakan nama pengguna dan kata sandi tertentu, Anda memiliki opsi untuk menyimpan kata sandi (menggunakan kotak centang untuk "Izinkan menyimpan kata sandi"); namun, opsi ini tidak aman. Disarankan agar Anda memilih Gunakan keamanan terintegrasi Windows NT; opsi ini aman karena mengenkripsi kata sandi. Mungkin ada situasi di mana Anda ingin memilih "Izinkan menyimpan kata sandi." Misalnya, jika Anda merilis pustaka dengan solusi database privat, Anda tidak boleh mengakses database secara langsung tetapi sebaliknya menggunakan aplikasi tingkat menengah untuk memverifikasi pengguna (melalui skema autentikasi apa pun yang Anda pilih) lalu membatasi jenis data yang tersedia untuk pengguna.

      3. Pilih database di server: Klik menu daftar drop-down untuk menampilkan semua database terdaftar di server data, dan pilih database.

        - atau -

        Lampirkan file database sebagai nama database: Tentukan file yang akan digunakan sebagai database; masukkan nama jalur eksplisit.

      Untuk data ODBC:

      1. Tentukan sumber data: Anda bisa menggunakan nama sumber data atau string koneksi.

        Gunakan nama sumber data: Daftar drop-down ini menampilkan sumber data yang terdaftar di komputer Anda. Anda dapat menyiapkan sumber data sebelumnya menggunakan Administrator Sumber Data ODBC

        - atau -

        Gunakan string koneksi: Masukkan string koneksi yang telah Anda peroleh, atau klik tombol Build; kotak dialog Pilih Sumber Data muncul. Pilih file atau sumber data komputer dan klik OK.

        Catatan

        Anda bisa mendapatkan string koneksi dengan melihat properti koneksi yang sudah ada di Server Explorer, atau Anda bisa membuat koneksi dengan mengklik ganda Tambahkan Koneksi di Penjelajah Server.

      2. Masukkan informasi untuk masuk ke server: Masukkan nama pengguna dan kata sandi untuk masuk ke server data.

      3. Masukkan katalog awal yang akan digunakan.

      4. Klik Uji Koneksi; jika pengujian berhasil, klik OK. Jika tidak, periksa informasi masuk Anda, coba database lain, atau coba server data lain.

    • Tab Tingkat Lanjut

      Pengaturan jaringan: Tentukan tingkat Peniruan (tingkat peniruan bahwa server diizinkan untuk digunakan saat meniru klien; sesuai langsung dengan tingkat peniruan RPC) dan Tingkat perlindungan (tingkat perlindungan data yang dikirim antara klien dan server; sesuai langsung dengan tingkat perlindungan RPC).

      Lainnya: Di Batas waktu sambungkan, tentukan jumlah detik waktu menganggur yang diizinkan sebelum batas waktu terjadi. Di Izin akses, tentukan izin akses pada koneksi data.

      Untuk informasi selengkapnya tentang properti inisialisasi tingkat lanjut, lihat dokumentasi yang disediakan dengan setiap penyedia OLE DB tertentu.

    • Semua tab

      Tab ini menampilkan ringkasan properti inisialisasi untuk sumber data dan koneksi yang telah Anda tentukan. Anda dapat mengedit nilai-nilai ini.

      Klik OK untuk menyelesaikan. Kotak dialog Pilih Objek Database muncul. Dari kotak dialog ini, pilih tabel, tampilan, atau prosedur tersimpan yang akan digunakan konsumen.

  • Kelas

    Setelah Anda memilih sumber data, kotak ini diisi dengan nama kelas default berdasarkan tabel atau prosedur tersimpan yang Anda pilih (lihat Memilih sumber data di bawah). Anda dapat mengedit nama kelas.

  • .h file

    Setelah Anda memilih sumber data, kotak ini diisi dengan nama kelas header default berdasarkan tabel atau prosedur tersimpan yang Anda pilih (lihat Pilih sumber data di bawah). Anda dapat mengedit nama file header atau memilih file header yang sudah ada.

  • Dikaitkan

    Opsi ini menentukan apakah wizard akan membuat kelas konsumen menggunakan atribut atau deklarasi templat. Saat Anda memilih opsi ini, wizard menggunakan atribut alih-alih deklarasi templat (ini adalah opsi default). Saat Anda membatalkan pilihan opsi ini, wizard menggunakan deklarasi templat alih-alih atribut.

    • Jika Anda memilih Tipe Tabel konsumen, wizard menggunakan db_source atribut dan db_table untuk membuat deklarasi kelas pengaktif tabel dan tabel, dan menggunakan db_column untuk membuat peta kolom. Misalnya, membuat peta ini:

      // Inject table class and table accessor class declarations
[db_source("<initialization_string>"), db_table("dbo.Orders")]
...
// Column map
[ db_column(1, status=m_dwOrderIDStatus, length=m_dwOrderIDLength) ] LONG m_OrderID;
[ db_column(2, status=m_dwCustomerIDStatus, length=m_dwCustomerIDLength) ] TCHAR m_CustomerID[6];
...

      alih-alih menggunakan CTable kelas templat untuk mendeklarasikan kelas aksesor tabel dan tabel, dan makro BEGIN_COLUMN_MAP dan END_COLUMN_MAP untuk membuat peta kolom, seperti dalam contoh ini:

      // Table accessor class
    class COrdersAccessor; // Table class
    class COrders : public CTable<CAccessor<COrdersAccessor>>;
// ...
// Column map
    BEGIN_COLUMN_MAP(COrderDetailsAccessor)
        COLUMN_ENTRY_LENGTH_STATUS(1, m_OrderID, m_dwOrderIDLength, m_dwOrderIDStatus)
        COLUMN_ENTRY_LENGTH_STATUS(2, m_CustomerID, m_dwCustomerIDLength, m_dwCustomerIDStatus)
        // ...
    END_COLUMN_MAP()

    • Jika Anda memilih Tipe Perintah konsumen, wizard menggunakan db_source atribut dan db_command , dan menggunakan db_column untuk membuat peta kolom. Misalnya, membuat peta ini:

      [db_source("<initialization_string>"), db_command("SQL_command")]
...
// Column map using db_column is the same as for consumer type of 'table'

      alih-alih menggunakan perintah dan deklarasi kelas aksesor perintah dalam file .h kelas perintah, misalnya:

      // Command accessor class:
    class CListOrdersAccessor;
// Command class:
    class CListOrders : public CCommand<CAccessor<CListOrdersAccessor>>;
// ...
// Column map using BEGIN_COLUMN_MAP ... END_COLUMN_MAP is the same as
// for consumer type of 'table'

      Lihat Mekanisme dasar atribut untuk informasi selengkapnya.

  • Jenis

    Pilih salah satu tombol radio ini untuk menentukan apakah kelas konsumen akan berasal dari CTable atau CCommand (default).

    • Table

      Pilih opsi ini jika Anda ingin menggunakan CTable atau db_table membuat deklarasi kelas aksesor tabel dan tabel.

    • Perintah

      Pilih opsi ini jika Anda ingin menggunakan CCommand atau db_command membuat perintah dan deklarasi kelas aksesor perintah. Ini adalah pilihan default.

  • Dukungan

    Pilih kotak centang untuk menentukan jenis pembaruan yang akan didukung di konsumen (defaultnya tidak ada). Masing-masing dari berikut ini akan mengatur DBPROP_IRowsetChange dan entri yang sesuai untuk DBPROP_UPDATABILITY dalam peta kumpulan properti.

    • Ubah

      Menentukan bahwa dukungan konsumen memperbarui data baris dalam set baris.

    • Sisipan

      Menentukan bahwa penyisipan dukungan konsumen baris ke dalam set baris.

    • Hapus

      Menentukan bahwa konsumen mendukung penghapusan baris dari set baris.

Lihat juga

Konsumen ATL OLE DB
Menambahkan Fungsionalitas dengan Wizard Kode
String Koneksi dan Tautan Data (OLE DB)