OleDbConnectionStringBuilder Kelas

Definisi

Ruang nama:

System.Data.OleDb

Rakitan:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v11.0.0-preview.4.26230.115

Sumber:

OleDbConnectionStringBuilder.cs

Menyediakan cara sederhana untuk membuat dan mengelola konten string koneksi yang digunakan oleh kelas OleDbConnection.

public ref class OleDbConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilder

[System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbConnectionStringBuilder+OleDbConnectionStringBuilderConverter))]
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder

[<System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbConnectionStringBuilder+OleDbConnectionStringBuilderConverter))>]
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbConnectionStringBuilder = class
    inherit DbConnectionStringBuilder

Public NotInheritable Class OleDbConnectionStringBuilder
Inherits DbConnectionStringBuilder

Warisan

Object

DbConnectionStringBuilder

OleDbConnectionStringBuilder

Atribut

TypeConverterAttribute RequiresDynamicCodeAttribute

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. Contoh ini juga mengurai string koneksi yang ada, dan menunjukkan berbagai cara untuk memanipulasi konten string koneksi.

Note

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 dalam 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 = "..."

    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 membuat string koneksi yang benar secara terprogram, 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 bekerja dengan perancang Visual Studio .NET pada waktu desain. Ketika pengembang menggunakan perancang untuk membangun Himpunan Data yang sangat di ketik dan koneksi yang sangat ditik dalam Visual Studio .NET, kelas penyusun string koneksi yang sangat ditik akan menampilkan properti yang terkait dengan jenisnya dan juga akan memiliki pengonversi 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 terkait 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:

Key	Property	Nilai standar
Nama File	FileName	""
Provider	Provider	""
Sumber data	DataSource	""
Simpan Informasi Keamanan	PersistSecurityInfo	False
Layanan OLE DB	OleDbServices	-13

Properti Item[] menangani upaya untuk menyisipkan entri berbahaya. Misalnya, kode berikut, menggunakan properti Item[] default (pengindeks, di C#) dengan benar lolos 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

Nama	Deskripsi
OleDbConnectionStringBuilder()	Menginisialisasi instans baru dari kelas OleDbConnectionStringBuilder.
OleDbConnectionStringBuilder(String)	Menginisialisasi instans baru dari kelas OleDbConnectionStringBuilder. String koneksi yang disediakan menyediakan data untuk informasi koneksi internal instans.

Properti

Nama	Deskripsi
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.
Item[String]	Mendapatkan atau mengatur nilai yang terkait dengan kunci yang ditentukan. Di C#, properti ini adalah pengindeks.
Keys	Mendapatkan yang ICollection berisi kunci di OleDbConnectionStringBuilder.
OleDbServices	Mendapatkan atau mengatur nilai yang akan diteruskan untuk kunci Layanan OLE DB dalam string koneksi.
PersistSecurityInfo	Mendapatkan atau mengatur 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.

Metode

Nama	Deskripsi
Clear()	Menghapus konten instans OleDbConnectionStringBuilder .
ContainsKey(String)	Menentukan apakah OleDbConnectionStringBuilder berisi kunci tertentu.
Remove(String)	Menghapus entri dengan kunci yang ditentukan dari OleDbConnectionStringBuilder instans.
TryGetValue(String, Object)	Mengambil nilai yang sesuai dengan kunci yang disediakan dari OleDbConnectionStringBuilder instans.

Lihat juga

• Pembuat String Koneksi
• String Koneksi dalam ADO.NET