OleDbConnectionStringBuilder Osztály

Definíció

Névtér:

System.Data.OleDb

Szerelvény:

System.Data.OleDb.dll

Csomag:

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

Forrás:

OleDbConnectionStringBuilder.cs

Egyszerű módot kínál az osztály által OleDbConnection használt kapcsolati sztringek tartalmának létrehozására és kezelésére.

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

Öröklődés

Object

DbConnectionStringBuilder

OleDbConnectionStringBuilder

Attribútumok

TypeConverterAttribute RequiresDynamicCodeAttribute

Példák

Az alábbi konzolalkalmazás kapcsolati sztringeket hoz létre több OLE DB-adatbázishoz. A példa először létrehoz egy kapcsolati karakterlánc egy Microsoft Access-adatbázishoz, majd létrehoz egy kapcsolati karakterlánc egy IBM DB2-adatbázishoz. A példa egy meglévő kapcsolati karakterlánc is elemez, és bemutatja a kapcsolati karakterlánc tartalmának manipulálásának különböző módjait.

Note

Ez a példa egy jelszót tartalmaz, amely bemutatja, hogyan OleDbConnectionStringBuilder működik a kapcsolati sztringek. Az alkalmazásokban javasoljuk, hogy Windows hitelesítést használjon. Ha jelszót kell használnia, ne tartalmazzon szigorúan kódolt jelszót az alkalmazásban.

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

Megjegyzések

A kapcsolati karakterlánc szerkesztő lehetővé teszi a fejlesztők számára a szintaktikailag helyes kapcsolati sztringek programozott létrehozását, valamint a meglévő kapcsolati sztringek elemzését és újraépítését az osztály tulajdonságainak és metódusainak használatával. A kapcsolati karakterlánc-szerkesztő az OLE DB-kapcsolatok által engedélyezett ismert kulcs-érték pároknak megfelelő, erősen gépelt tulajdonságokat biztosít, és a fejlesztők tetszőleges kulcs/érték párokat adhatnak hozzá bármely más kapcsolati karakterlánc értékhez. Az OleDbConnectionStringBuilder osztály megvalósítja az ICustomTypeDescriptor felületet. Ez azt jelenti, hogy az osztály tervezéskor Visual Studio .NET tervezőkkel dolgozik. Ha a fejlesztők a tervezővel készítenek erősen gépelt adathalmazokat és erősen gépelt kapcsolatokat Visual Studio .NET belül, az erősen beírt kapcsolati karakterlánc builder osztály megjeleníti a típusához társított tulajdonságokat, és konverterekkel is rendelkezik, amelyek leképezik az ismert kulcsok közös értékeit.

Az alkalmazások részeként kapcsolati sztringeket létrehozó fejlesztők az OleDbConnectionStringBuilder osztály használatával hozhatnak létre és módosíthatnak kapcsolati sztringeket. Az osztály megkönnyíti az alkalmazáskonfigurációs fájlban tárolt kapcsolati sztringek kezelését is. A OleDbConnectionStringBuilder rendszer csak az ismert kulcs/érték párok korlátozott készletét ellenőrzi. Ezért ez az osztály érvénytelen kapcsolati sztringek létrehozására használható. Az alábbi táblázat az osztály ismert kulcsait és azok megfelelő tulajdonságait, valamint az OleDbConnectionStringBuilder alapértelmezett értékeket sorolja fel. Ezen értékek mellett a fejlesztők bármilyen kulcs-/értékpárt hozzáadhatnak a OleDbConnectionStringBuilder példányban található gyűjteményhez:

Key	Ingatlan	Alapértelmezett érték
Fájlnév	FileName	""
Provider	Provider	""
Adatforrás	DataSource	""
Biztonsági adatok megőrzése	PersistSecurityInfo	Téves
OLE DB-szolgáltatások	OleDbServices	-13

A Item[] tulajdonság kezeli a rosszindulatú bejegyzések beszúrására tett kísérleteket. A következő kód például az alapértelmezett Item[] tulajdonság (az indexelő C#-ban) használatával helyesen menekül a beágyazott kulcs/érték pártól:

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";

Az eredmény a következő kapcsolati karakterlánc, amely biztonságosan kezeli az érvénytelen értéket:

Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Sample.mdb;User ID="Admin;NewValue=Bad"

Konstruktorok

Name	Description
OleDbConnectionStringBuilder()	Inicializálja a OleDbConnectionStringBuilder osztály új példányát.
OleDbConnectionStringBuilder(String)	Inicializálja a OleDbConnectionStringBuilder osztály új példányát. A megadott kapcsolati karakterlánc biztosítják a példány belső kapcsolati adatainak adatait.

Tulajdonságok

Name	Description
DataSource	Lekéri vagy beállítja annak az adatforrásnak a nevét, amelyhez csatlakozni szeretne.
FileName	Lekéri vagy beállítja az univerzális adatkapcsolat (UDL) fájl nevét az adatforráshoz való csatlakozáshoz.
Item[String]	Lekéri vagy beállítja a megadott kulccsal társított értéket. A C#-ban ez a tulajdonság az indexelő.
Keys	ICollection Lekéri azokat a kulcsokat, amelyek a OleDbConnectionStringBuilder.
OleDbServices	Lekéri vagy beállítja a kapcsolati karakterlánc belüli OLE DB Services-kulcs átadandó értékét.
PersistSecurityInfo	Lekéri vagy beállít egy logikai értéket, amely jelzi, hogy a rendszer a kapcsolat részeként visszaadja-e a biztonsági szempontból érzékeny információkat, például a jelszót, ha a kapcsolat nyitva van, vagy valaha is nyitott állapotban volt.
Provider	Lekéri vagy beállít egy sztringet, amely tartalmazza a belső kapcsolati karakterlánc társított adatszolgáltató nevét.

Metódusok

Name	Description
Clear()	Törli a példány tartalmát OleDbConnectionStringBuilder .
ContainsKey(String)	Meghatározza, hogy a OleDbConnectionStringBuilder kulcs tartalmaz-e egy adott kulcsot.
Remove(String)	Eltávolítja a megadott kulccsal rendelkező bejegyzést a OleDbConnectionStringBuilder példányból.
TryGetValue(String, Object)	Lekéri a megadott kulcsnak megfelelő értéket a OleDbConnectionStringBuilder példányból.

Lásd még

• Kapcsolati karakterlánc-generátorok
• Kapcsolati sztringek a ADO.NET