OleDbConnectionStringBuilder Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan cara sederhana untuk membuat dan mengelola konten string koneksi yang digunakan oleh OleDbConnection kelas .
public ref class OleDbConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilder[System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbConnectionStringBuilder+OleDbConnectionStringBuilderConverter))]
public sealed class OleDbConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder[<System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbConnectionStringBuilder+OleDbConnectionStringBuilderConverter))>]
type OleDbConnectionStringBuilder = class
inherit DbConnectionStringBuilderPublic NotInheritable Class OleDbConnectionStringBuilder
Inherits DbConnectionStringBuilder- Warisan
- Atribut
Contoh
Aplikasi konsol berikut membangun string koneksi untuk beberapa database OLE DB. Pertama, contoh membuat string koneksi untuk database Microsoft Access, lalu membuat string koneksi untuk database IBM DB2. Contohnya juga mengurai string koneksi yang ada, dan menunjukkan berbagai cara untuk memanipulasi konten string koneksi.
Catatan
Contoh ini mencakup kata sandi untuk menunjukkan cara OleDbConnectionStringBuilder kerja dengan string koneksi. Di aplikasi Anda, kami sarankan Anda menggunakan Autentikasi Windows. Jika Anda harus menggunakan kata sandi, jangan sertakan kata sandi yang dikodekan secara permanen di aplikasi Anda.
using System.Data.OleDb;
class Program
{
static void Main(string[] args)
{
OleDbConnectionStringBuilder builder = new OleDbConnectionStringBuilder();
builder.ConnectionString = @"Data Source=C:\Sample.mdb";
// Call the Add method to explicitly add key/value
// pairs to the internal collection.
builder.Add("Provider", "Microsoft.Jet.Oledb.4.0");
builder.Add("Jet OLEDB:Database Password", "MyPassword!");
builder.Add("Jet OLEDB:System Database", @"C:\Workgroup.mdb");
// Set up row-level locking.
builder.Add("Jet OLEDB:Database Locking Mode", 1);
Console.WriteLine(builder.ConnectionString);
Console.WriteLine();
// Clear current values and reset known keys to their
// default values.
builder.Clear();
// Pass the OleDbConnectionStringBuilder an existing
// connection string, and you can retrieve and
// modify any of the elements.
builder.ConnectionString =
"Provider=DB2OLEDB;Network Transport Library=TCPIP;" +
"Network Address=192.168.0.12;Initial Catalog=DbAdventures;" +
"Package Collection=SamplePackage;Default Schema=SampleSchema;";
Console.WriteLine("Network Address = " + builder["Network Address"].ToString());
Console.WriteLine();
// Modify existing items.
builder["Package Collection"] = "NewPackage";
builder["Default Schema"] = "NewSchema";
// Call the Remove method to remove items from
// the collection of key/value pairs.
builder.Remove("User ID");
// Note that calling Remove on a nonexistent item does not
// throw an exception.
builder.Remove("BadItem");
Console.WriteLine(builder.ConnectionString);
Console.WriteLine();
// Setting the indexer adds the value, if
// necessary.
builder["User ID"] = "SampleUser";
builder["Password"] = "SamplePassword";
Console.WriteLine(builder.ConnectionString);
Console.WriteLine("Press Enter to finish.");
Console.ReadLine();
}
}
Imports System.Data.OleDb
Imports System.Collections
Module Module1
Sub Main()
Dim builder As New OleDbConnectionStringBuilder()
builder.ConnectionString = "Data Source=C:\Sample.mdb"
' Call the Add method to explicitly add key/value
' pairs to the internal collection.
builder.Add("Provider", "Microsoft.Jet.Oledb.4.0")
builder.Add("Jet OLEDB:Database Password", "MyPassword!")
builder.Add("Jet OLEDB:System Database", "C:\Workgroup.mdb")
' Set up row-level locking.
builder.Add("Jet OLEDB:Database Locking Mode", 1)
Console.WriteLine(builder.ConnectionString)
Console.WriteLine()
' Clear current values and reset known keys to their
' default values.
builder.Clear()
' Pass the OleDbConnectionStringBuilder an existing
' connection string, and you can retrieve and
' modify any of the elements.
builder.ConnectionString = _
"Provider=DB2OLEDB;Network Transport Library=TCPIP;" & _
"Network Address=192.168.0.12;Initial Catalog=DbAdventures;" & _
"Package Collection=SamplePackage;Default Schema=SampleSchema;"
Console.WriteLine("Network Address = " & builder("Network Address").ToString())
Console.WriteLine()
' Modify existing items.
builder("Package Collection") = "NewPackage"
builder("Default Schema") = "NewSchema"
' Call the Remove method to remove items from
' the collection of key/value pairs.
builder.Remove("User ID")
' Note that calling Remove on a nonexistent item does not
' throw an exception.
builder.Remove("BadItem")
Console.WriteLine(builder.ConnectionString)
Console.WriteLine()
' The Item property is the default for the class,
' and setting the Item property adds the value, if
' necessary.
builder("User ID") = "SampleUser"
builder("Password") = "SamplePassword"
Console.WriteLine(builder.ConnectionString)
Console.WriteLine("Press Enter to finish.")
Console.ReadLine()
End Sub
End Module
Keterangan
Penyusun string koneksi memungkinkan pengembang secara terprogram membuat string koneksi yang benar secara sintaksis, dan mengurai dan membangun kembali string koneksi yang ada, menggunakan properti dan metode kelas. Penyusun string koneksi menyediakan properti yang sangat ditik yang sesuai dengan pasangan kunci/nilai yang diketahui yang diizinkan oleh koneksi OLE DB, dan pengembang dapat menambahkan pasangan kunci/nilai arbitrer untuk nilai string koneksi lainnya. Kelas OleDbConnectionStringBuilder menerapkan antarmuka ICustomTypeDescriptor. Ini berarti bahwa kelas berfungsi dengan desainer Visual Studio .NET pada waktu desain. Ketika pengembang menggunakan perancang untuk membangun Himpunan Data yang di ketik dengan kuat dan koneksi yang sangat ditik dalam Visual Studio .NET, kelas penyusun string koneksi yang ditik akan menampilkan properti yang terkait dengan jenisnya dan juga akan memiliki konverter yang dapat memetakan nilai umum untuk kunci yang diketahui.
Pengembang perlu membuat string koneksi sebagai bagian dari aplikasi dapat menggunakan OleDbConnectionStringBuilder kelas untuk membangun dan memodifikasi string koneksi. Kelas ini juga memudahkan untuk mengelola string koneksi yang disimpan dalam file konfigurasi aplikasi. melakukan OleDbConnectionStringBuilder pemeriksaan hanya untuk sekumpulan terbatas pasangan kunci/nilai yang diketahui. Oleh karena itu, kelas ini dapat digunakan untuk membuat string koneksi yang tidak valid. Tabel berikut mencantumkan kunci yang diketahui dan properti terkaitnya dalam OleDbConnectionStringBuilder kelas , dan nilai defaultnya. Selain nilai spesifik ini, pengembang dapat menambahkan pasangan kunci/nilai apa pun ke koleksi yang terkandung dalam OleDbConnectionStringBuilder instans:
| Kunci | Properti | Nilai default |
|---|---|---|
| Nama File | FileName | "" |
| Penyedia | Provider | "" |
| Sumber Data. | DataSource | "" |
| Pertahankan Info Keamanan | PersistSecurityInfo | Salah |
| Layanan OLE DB | OleDbServices | -13 |
Properti Item[] menangani upaya untuk menyisipkan entri berbahaya. Misalnya, kode berikut, menggunakan properti default Item[] (pengindeks, di C#) dengan benar keluar dari pasangan kunci/nilai berlapis:
Dim builder As _
New System.Data.OleDb.OleDbConnectionStringBuilder
builder("Provider") = "Microsoft.Jet.OLEDB.4.0"
builder("Data Source") = "C:\Sample.mdb"
builder("User Id") = "Admin;NewValue=Bad"
System.Data.OleDb.OleDbConnectionStringBuilder builder =
new System.Data.OleDb.OleDbConnectionStringBuilder();
builder["Provider"] = "Microsoft.Jet.OLEDB.4.0";
builder["Data Source"] = "C:\\Sample.mdb";
builder["User Id"] = "Admin;NewValue=Bad";
Hasilnya adalah string koneksi berikut yang menangani nilai yang tidak valid dengan cara yang aman:
Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Sample.mdb;User ID="Admin;NewValue=Bad"
Konstruktor
| OleDbConnectionStringBuilder() |
Menginisialisasi instans baru kelas OleDbConnectionStringBuilder. |
| OleDbConnectionStringBuilder(String) |
Menginisialisasi instans baru kelas OleDbConnectionStringBuilder. string koneksi yang disediakan menyediakan data untuk informasi koneksi internal instans. |
Properti
| BrowsableConnectionString |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah ConnectionString properti terlihat di perancang Visual Studio. (Diperoleh dari DbConnectionStringBuilder) |
| ConnectionString |
Mendapatkan atau mengatur string koneksi yang terkait dengan DbConnectionStringBuilder. (Diperoleh dari DbConnectionStringBuilder) |
| Count |
Mendapatkan jumlah kunci saat ini yang terkandung dalam ConnectionString properti . (Diperoleh dari DbConnectionStringBuilder) |
| DataSource |
Mendapatkan atau mengatur nama sumber data yang akan disambungkan. |
| FileName |
Mendapatkan atau mengatur nama file Universal Data Link (UDL) untuk menyambungkan ke sumber data. |
| IsFixedSize |
Mendapatkan nilai yang menunjukkan apakah DbConnectionStringBuilder memiliki ukuran tetap. (Diperoleh dari DbConnectionStringBuilder) |
| IsReadOnly |
Mendapatkan nilai yang menunjukkan apakah DbConnectionStringBuilder bersifat baca-saja. (Diperoleh dari DbConnectionStringBuilder) |
| Item[String] |
Mendapatkan atau mengatur nilai yang terkait dengan kunci yang ditentukan. Di C#, properti ini adalah pengindeks. |
| Keys |
ICollection Mendapatkan yang berisi kunci di OleDbConnectionStringBuilder. |
| OleDbServices |
Mendapatkan atau menetapkan nilai yang akan diteruskan untuk kunci Layanan OLE DB dalam string koneksi. |
| PersistSecurityInfo |
Mendapatkan atau menetapkan nilai Boolean yang menunjukkan apakah informasi sensitif keamanan, seperti kata sandi, dikembalikan sebagai bagian dari koneksi jika koneksi terbuka atau pernah dalam status terbuka. |
| Provider |
Mendapatkan atau mengatur string yang berisi nama penyedia data yang terkait dengan string koneksi internal. |
| Values |
ICollection Mendapatkan yang berisi nilai dalam DbConnectionStringBuilder. (Diperoleh dari DbConnectionStringBuilder) |
Metode
| Add(String, Object) |
Menambahkan entri dengan kunci dan nilai yang ditentukan ke DbConnectionStringBuilderdalam . (Diperoleh dari DbConnectionStringBuilder) |
| Clear() |
Menghapus konten instans OleDbConnectionStringBuilder . |
| ClearPropertyDescriptors() |
Menghapus kumpulan PropertyDescriptor objek pada yang terkait DbConnectionStringBuilder. (Diperoleh dari DbConnectionStringBuilder) |
| ContainsKey(String) |
Menentukan apakah OleDbConnectionStringBuilder berisi kunci tertentu. |
| Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
| EquivalentTo(DbConnectionStringBuilder) |
Membandingkan informasi koneksi dalam objek ini DbConnectionStringBuilder dengan informasi koneksi dalam objek yang disediakan. (Diperoleh dari DbConnectionStringBuilder) |
| GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
| GetProperties(Hashtable) |
Mengisi yang disediakan Hashtable dengan informasi tentang semua properti ini DbConnectionStringBuilder. (Diperoleh dari DbConnectionStringBuilder) |
| GetType() |
Mendapatkan dari instans Type saat ini. (Diperoleh dari Object) |
| MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
| Remove(String) |
Menghapus entri dengan kunci yang ditentukan dari OleDbConnectionStringBuilder instans. |
| ShouldSerialize(String) |
Menunjukkan apakah kunci yang ditentukan ada dalam instans ini DbConnectionStringBuilder . (Diperoleh dari DbConnectionStringBuilder) |
| ToString() |
Mengembalikan string koneksi yang terkait dengan iniDbConnectionStringBuilder. (Diperoleh dari DbConnectionStringBuilder) |
| TryGetValue(String, Object) |
Mengambil nilai yang sesuai dengan kunci yang disediakan dari OleDbConnectionStringBuilder instans. |
Implementasi Antarmuka Eksplisit
| ICollection.CopyTo(Array, Int32) |
Menyalin elemen ICollection ke Array, dimulai dari indeks tertentu Array . (Diperoleh dari DbConnectionStringBuilder) |
| ICollection.IsSynchronized |
Mendapatkan nilai yang menunjukkan apakah akses ke disinkronkan ICollection (utas aman). (Diperoleh dari DbConnectionStringBuilder) |
| ICollection.SyncRoot |
Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke ICollection. (Diperoleh dari DbConnectionStringBuilder) |
| ICustomTypeDescriptor.GetAttributes() |
Mengembalikan kumpulan atribut kustom untuk instans komponen ini. (Diperoleh dari DbConnectionStringBuilder) |
| ICustomTypeDescriptor.GetClassName() |
Mengembalikan nama kelas dari instans komponen ini. (Diperoleh dari DbConnectionStringBuilder) |
| ICustomTypeDescriptor.GetComponentName() |
Mengembalikan nama instans komponen ini. (Diperoleh dari DbConnectionStringBuilder) |
| ICustomTypeDescriptor.GetConverter() |
Mengembalikan pengonversi jenis untuk instans komponen ini. (Diperoleh dari DbConnectionStringBuilder) |
| ICustomTypeDescriptor.GetDefaultEvent() |
Mengembalikan peristiwa default untuk instans komponen ini. (Diperoleh dari DbConnectionStringBuilder) |
| ICustomTypeDescriptor.GetDefaultProperty() |
Mengembalikan properti default untuk instans komponen ini. (Diperoleh dari DbConnectionStringBuilder) |
| ICustomTypeDescriptor.GetEditor(Type) |
Mengembalikan editor dari jenis yang ditentukan untuk instans komponen ini. (Diperoleh dari DbConnectionStringBuilder) |
| ICustomTypeDescriptor.GetEvents() |
Mengembalikan peristiwa untuk instans komponen ini. (Diperoleh dari DbConnectionStringBuilder) |
| ICustomTypeDescriptor.GetEvents(Attribute[]) |
Mengembalikan peristiwa untuk instans komponen ini menggunakan array atribut yang ditentukan sebagai filter. (Diperoleh dari DbConnectionStringBuilder) |
| ICustomTypeDescriptor.GetProperties() |
Mengembalikan properti untuk instans komponen ini. (Diperoleh dari DbConnectionStringBuilder) |
| ICustomTypeDescriptor.GetProperties(Attribute[]) |
Mengembalikan properti untuk instans komponen ini menggunakan array atribut sebagai filter. (Diperoleh dari DbConnectionStringBuilder) |
| ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor) |
Mengembalikan objek yang berisi properti yang dijelaskan oleh deskriptor properti yang ditentukan. (Diperoleh dari DbConnectionStringBuilder) |
| IDictionary.Add(Object, Object) |
Menambahkan elemen dengan kunci dan nilai yang disediakan ke IDictionary objek . (Diperoleh dari DbConnectionStringBuilder) |
| IDictionary.Contains(Object) |
Menentukan apakah IDictionary objek berisi elemen dengan kunci yang ditentukan. (Diperoleh dari DbConnectionStringBuilder) |
| IDictionary.GetEnumerator() |
Mengembalikan IDictionaryEnumerator objek untuk IDictionary objek . (Diperoleh dari DbConnectionStringBuilder) |
| IDictionary.Item[Object] |
Mendapatkan atau mengatur elemen dengan kunci yang ditentukan. (Diperoleh dari DbConnectionStringBuilder) |
| IDictionary.Remove(Object) |
Menghapus elemen dengan kunci yang ditentukan dari IDictionary objek . (Diperoleh dari DbConnectionStringBuilder) |
| IEnumerable.GetEnumerator() |
Mengembalikan enumerator yang berulang melalui koleksi. (Diperoleh dari DbConnectionStringBuilder) |
Metode Ekstensi
| Cast<TResult>(IEnumerable) |
Mentransmisikan elemen dari ke IEnumerable jenis yang ditentukan. |
| OfType<TResult>(IEnumerable) |
Memfilter elemen berdasarkan IEnumerable jenis yang ditentukan. |
| AsParallel(IEnumerable) |
Mengaktifkan paralelisasi kueri. |
| AsQueryable(IEnumerable) |
Mengonversi menjadi IEnumerableIQueryable. |
Berlaku untuk
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk