Menerapkan kelas Koneksi ion untuk ekstensi pemrosesan data

  • Artikel

Objek Koneksi ion mewakili koneksi database atau sumber daya serupa dan merupakan titik awal untuk pengguna ekstensi pemrosesan data SQL Server Reporting Services. Ini mewakili koneksi ke server database, meskipun entitas apa pun dengan perilaku serupa dapat diekspos sebagai Koneksi ion.

Untuk menerapkan objek Koneksi ion, buat kelas yang mengimplementasikan IDbConnection dan secara opsional mengimplementasikan IDbConnectionExtension.

Dalam implementasi Anda, Anda harus memastikan bahwa koneksi dibuat dan dibuka sebelum perintah dapat dijalankan. Pastikan bahwa implementasi Anda mengharuskan klien untuk membuka dan menutup koneksi secara eksplisit, daripada meminta implementasi Anda membuka dan menutup koneksi secara implisit untuk klien. Lakukan pemeriksaan keamanan Anda ketika koneksi diperoleh. Memerlukan koneksi yang ada untuk kelas lain di ekstensi pemrosesan data SSRS Anda memastikan bahwa pemeriksaan keamanan selalu dilakukan saat bekerja dengan sumber data Anda.

Properti koneksi yang diinginkan diwakili sebagai string koneksi. Ekstensi pemrosesan data SSRS harus mendukung ConnectionString properti menggunakan sistem pasangan nama/nilai yang sudah dikenal yang ditentukan oleh OLE DB.

Catatan

objek Koneksi ion sering kali intensif sumber daya untuk diperoleh, jadi Anda mungkin ingin mempertimbangkan untuk mengumpulkan koneksi atau teknik lain untuk mengurangi hal ini.

IDbConnection mewarisi dari IExtension. Anda harus menerapkan IExtension antarmuka sebagai bagian dari implementasi kelas koneksi Anda. Antarmuka IExtension memungkinkan kelas untuk menerapkan nama ekstensi yang dilokalkan dan memproses informasi konfigurasi khusus ekstensi yang disimpan dalam file konfigurasi Reporting Services.

Objek Koneksi Anda berisi LocalizedName properti melalui implementasinya .IExtension Ekstensi pemrosesan data Reporting Services harus mendukung LocalizedName properti . Dukungan memungkinkan pengguna menemukan nama yang akrab dan dilokalkan untuk ekstensi di antarmuka pengguna, seperti Report Manager.

IExtensionjuga memungkinkan objek Koneksi ion Anda untuk mengambil dan memproses data konfigurasi kustom yang disimpan dalam file RSReportServer.config. Untuk informasi selengkapnya tentang memproses data konfigurasi kustom, lihat SetConfiguration metode .

Kelas yang mengimplementasikan IExtension tidak dibongkar dari memori saat kelas ekstensi pemrosesan data Anda lainnya dibongkar. Karena fakta ini, Anda dapat menggunakan kelas Ekstensi untuk menyimpan informasi status lintas koneksi atau untuk menyimpan data yang dapat di-cache dalam memori. Kelas Ekstensi Anda tetap dalam memori selama server laporan berjalan.

Anda dapat memperluas kelas Koneksi ion Anda untuk menyertakan dukungan untuk kredensial di Reporting Services dengan menerapkan IDbConnectionExtension. Saat Anda menerapkan properti , UserName, dan Password antarmuka, Anda mengaktifkan kotak centang Keamanan Terintegrasi dan kotak teks Nama Pengguna dan Kata Sandi dialog Sumber Data di IDbConnectionExtension Perancang Laporan.IntegratedSecurity Ini memungkinkan Perancang Laporan menyimpan dan mengambil kredensial untuk sumber data yang mendukung autentikasi. Kredensial disimpan dengan aman dan digunakan saat menyajikan laporan dalam mode pratinjau.

Catatan

Menerapkan IDbConnectionExtension secara implisit mengharuskan Anda untuk mengimplementasikan anggota IDbConnection antarmuka dan IExtension .

Untuk contoh implementasi kelas Koneksi ion, lihat Sampel Reporting Services di CodePlex (SQL Server Reporting Services SSRS).

Konten terkait