Sdílet prostřednictvím


OleDbConnectionStringBuilder Třída

Definice

Poskytuje jednoduchý způsob, jak vytvořit a spravovat obsah připojovacích řetězců používaných OleDbConnection třídou .

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
Dědičnost
OleDbConnectionStringBuilder
Atributy

Příklady

Následující konzolová aplikace sestaví připojovací řetězce pro několik databází OLE DB. Příklad nejprve vytvoří připojovací řetězec pro databázi Microsoft Access a pak vytvoří připojovací řetězec pro databázi IBM DB2. Příklad také parsuje existující připojovací řetězec a ukazuje různé způsoby manipulace s obsahem připojovací řetězec.

Poznámka

Tento příklad obsahuje heslo, které ukazuje, jak OleDbConnectionStringBuilder funguje s připojovacími řetězci. Ve vašich aplikacích doporučujeme používat ověřování systému Windows. Pokud je nutné použít heslo, nevkládejte do své aplikace pevně zakódované heslo.

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

Poznámky

Tvůrce připojovací řetězec umožňuje vývojářům programově vytvářet syntakticky správné připojovací řetězce a parsovat a znovu sestavit existující připojovací řetězce pomocí vlastností a metod třídy . Tvůrce připojovací řetězec poskytuje vlastnosti silného typu odpovídající známým párům klíč/hodnota povoleným připojeními OLE DB a vývojáři mohou přidat libovolné páry klíč/hodnota pro jakékoli jiné připojovací řetězec hodnoty. Třída OleDbConnectionStringBuilder implementuje rozhraní ICustomTypeDescriptor. To znamená, že třída pracuje s návrháři sady Visual Studio .NET v době návrhu. Když vývojáři pomocí návrháře vytvářejí datové sady silného typu a připojení silného typu v rámci visual studio .NET, třída připojovací řetězec builderu se silnými typy zobrazí vlastnosti přidružené k jejímu typu a bude mít také převaděče, které mohou mapovat společné hodnoty pro známé klíče.

Vývojáři, kteří potřebují vytvořit připojovací řetězce jako součást aplikací, můžou pomocí OleDbConnectionStringBuilder třídy vytvářet a upravovat připojovací řetězce. Třída také usnadňuje správu připojovacích řetězců uložených v konfiguračním souboru aplikace. Nástroj OleDbConnectionStringBuilder kontroluje pouze omezenou sadu známých párů klíč/hodnota. Proto lze tuto třídu použít k vytvoření neplatných připojovacích řetězců. Následující tabulka obsahuje seznam známých klíčů a jejich odpovídajících vlastností v rámci OleDbConnectionStringBuilder třídy a jejich výchozích hodnot. Kromě těchto konkrétních hodnot mohou vývojáři do kolekce přidat jakékoli páry klíč/hodnota, které jsou součástí OleDbConnectionStringBuilder instance:

Klíč Vlastnost Výchozí hodnota
Název souboru FileName ""
Poskytovatel Provider ""
Zdroj dat DataSource ""
Zachování bezpečnostních údajů PersistSecurityInfo Ne
Služby OLE DB OleDbServices -13

Vlastnost Item[] zpracovává pokusy o vložení škodlivých položek. Například následující kód pomocí výchozí Item[] vlastnosti (indexer v jazyce C#) správně unikne do vnořené dvojice klíč/hodnota:

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

Výsledkem je následující připojovací řetězec, který zpracovává neplatnou hodnotu bezpečným způsobem:

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

Konstruktory

OleDbConnectionStringBuilder()

Inicializuje novou instanci OleDbConnectionStringBuilder třídy .

OleDbConnectionStringBuilder(String)

Inicializuje novou instanci OleDbConnectionStringBuilder třídy . Poskytnutá připojovací řetězec poskytuje data pro interní informace o připojení instance.

Vlastnosti

BrowsableConnectionString

Získá nebo nastaví hodnotu, která označuje, zda ConnectionString je vlastnost viditelná v návrhářích sady Visual Studio.

(Zděděno od DbConnectionStringBuilder)
ConnectionString

Získá nebo nastaví připojovací řetězec přidružené k DbConnectionStringBuilder.

(Zděděno od DbConnectionStringBuilder)
Count

Získá aktuální počet klíčů, které jsou obsaženy v vlastnosti ConnectionString .

(Zděděno od DbConnectionStringBuilder)
DataSource

Získá nebo nastaví název zdroje dat pro připojení.

FileName

Získá nebo nastaví název souboru Universal Data Link (UDL) pro připojení ke zdroji dat.

IsFixedSize

Získá hodnotu, která označuje, zda DbConnectionStringBuilder má pevnou velikost.

(Zděděno od DbConnectionStringBuilder)
IsReadOnly

Získá hodnotu, která označuje, zda DbConnectionStringBuilder je jen pro čtení.

(Zděděno od DbConnectionStringBuilder)
Item[String]

Získá nebo nastaví hodnotu přidruženou k zadanému klíči. V jazyce C# je tato vlastnost indexerem.

Keys

Získá , ICollection který obsahuje klíče v OleDbConnectionStringBuilder.

OleDbServices

Získá nebo nastaví hodnotu, která má být předána pro klíč služeb OLE DB v rámci připojovací řetězec.

PersistSecurityInfo

Získá nebo nastaví logickou hodnotu, která označuje, zda informace citlivé na zabezpečení, jako je heslo, jsou vráceny jako součást připojení, pokud je připojení otevřené nebo bylo někdy v otevřeném stavu.

Provider

Získá nebo nastaví řetězec, který obsahuje název zprostředkovatele dat přidruženého k interní připojovací řetězec.

Values

Získá , ICollection který obsahuje hodnoty v DbConnectionStringBuilder.

(Zděděno od DbConnectionStringBuilder)

Metody

Add(String, Object)

Přidá položku se zadaným klíčem a hodnotou do objektu DbConnectionStringBuilder.

(Zděděno od DbConnectionStringBuilder)
Clear()

Vymaže obsah OleDbConnectionStringBuilder instance.

ClearPropertyDescriptors()

Vymaže kolekci PropertyDescriptor objektů v přidruženém DbConnectionStringBuilderobjektu .

(Zděděno od DbConnectionStringBuilder)
ContainsKey(String)

Určuje, zda obsahuje OleDbConnectionStringBuilder konkrétní klíč.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
EquivalentTo(DbConnectionStringBuilder)

Porovná informace o připojení v tomto DbConnectionStringBuilder objektu s informacemi o připojení v zadaném objektu.

(Zděděno od DbConnectionStringBuilder)
GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetProperties(Hashtable)

Vyplní zadaný Hashtable objekt informacemi o všech vlastnostech tohoto DbConnectionStringBuilderobjektu .

(Zděděno od DbConnectionStringBuilder)
GetType()

Type Získá z aktuální instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
Remove(String)

Odebere z instance položku se zadaným OleDbConnectionStringBuilder klíčem.

ShouldSerialize(String)

Určuje, zda zadaný klíč existuje v této DbConnectionStringBuilder instanci.

(Zděděno od DbConnectionStringBuilder)
ToString()

Vrátí připojovací řetězec přidružené k tomuto DbConnectionStringBuilder.

(Zděděno od DbConnectionStringBuilder)
TryGetValue(String, Object)

Načte z instance hodnotu odpovídající zadanému klíči OleDbConnectionStringBuilder .

Explicitní implementace rozhraní

ICollection.CopyTo(Array, Int32)

Zkopíruje prvky objektu ICollectionArraydo , počínaje konkrétním Array indexem.

(Zděděno od DbConnectionStringBuilder)
ICollection.IsSynchronized

Získá hodnotu označující, zda přístup k objektu ICollection je synchronizován (bezpečný pro přístup z více vláken).

(Zděděno od DbConnectionStringBuilder)
ICollection.SyncRoot

Získá objekt, který lze použít k synchronizaci přístupu k .ICollection

(Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()

Vrátí kolekci vlastních atributů pro tuto instanci komponenty.

(Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()

Vrátí název třídy této instance komponenty.

(Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()

Vrátí název této instance komponenty.

(Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()

Vrátí převaděč typů pro tuto instanci komponenty.

(Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()

Vrátí výchozí událost pro tuto instanci komponenty.

(Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()

Vrátí výchozí vlastnost pro tuto instanci komponenty.

(Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)

Vrátí editor zadaného typu pro tuto instanci komponenty.

(Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()

Vrátí události pro tuto instanci komponenty.

(Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])

Vrátí události pro tuto instanci komponenty pomocí zadaného pole atributů jako filtr.

(Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()

Vrátí vlastnosti pro tuto instanci komponenty.

(Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])

Vrátí vlastnosti pro tuto instanci komponenty pomocí pole atributů jako filtr.

(Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)

Vrátí objekt, který obsahuje vlastnost popsanou zadaným popisovačem vlastnosti.

(Zděděno od DbConnectionStringBuilder)
IDictionary.Add(Object, Object)

Přidá prvek se zadaným klíčem a hodnotou do objektu IDictionary .

(Zděděno od DbConnectionStringBuilder)
IDictionary.Contains(Object)

Určuje, zda IDictionary objekt obsahuje prvek se zadaným klíčem.

(Zděděno od DbConnectionStringBuilder)
IDictionary.GetEnumerator()

IDictionaryEnumerator Vrátí objekt pro IDictionary objekt .

(Zděděno od DbConnectionStringBuilder)
IDictionary.Item[Object]

Získá nebo nastaví prvek se zadaným klíčem.

(Zděděno od DbConnectionStringBuilder)
IDictionary.Remove(Object)

Odebere prvek se zadaným klíčem z objektu IDictionary .

(Zděděno od DbConnectionStringBuilder)
IEnumerable.GetEnumerator()

Vrací enumerátor procházející kolekci.

(Zděděno od DbConnectionStringBuilder)

Metody rozšíření

Cast<TResult>(IEnumerable)

Přetypuje prvky objektu na IEnumerable zadaný typ.

OfType<TResult>(IEnumerable)

Filtruje prvky objektu IEnumerable na základě zadaného typu.

AsParallel(IEnumerable)

Umožňuje paralelizaci dotazu.

AsQueryable(IEnumerable)

Převede objekt na IEnumerableIQueryable.

Platí pro

Viz také