Bagikan melalui


OleDbConnectionStringBuilder Kelas

Definisi

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 DbConnectionStringBuilder
Public NotInheritable Class OleDbConnectionStringBuilder
Inherits DbConnectionStringBuilder
Warisan
OleDbConnectionStringBuilder
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