OleDbConnectionStringBuilder Konstruktory

Definice

Obor názvů:

System.Data.OleDb

Sestavení:

System.Data.OleDb.dll

Balíček:

System.Data.OleDb v8.0.0

Inicializuje novou instanci OleDbConnectionStringBuilder třídy .

Přetížení

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.

OleDbConnectionStringBuilder()

Zdroj:

OleDbConnectionStringBuilder.cs

Inicializuje novou instanci OleDbConnectionStringBuilder třídy .

public:
 OleDbConnectionStringBuilder();

public OleDbConnectionStringBuilder ();

Public Sub New ()

Viz také

• Tvůrci připojovacích řetězců
• Připojovací řetězce v ADO.NET

OleDbConnectionStringBuilder(String)

Zdroj:

OleDbConnectionStringBuilder.cs

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

public:
 OleDbConnectionStringBuilder(System::String ^ connectionString);

public OleDbConnectionStringBuilder (string? connectionString);

new System.Data.OleDb.OleDbConnectionStringBuilder : string -> System.Data.OleDb.OleDbConnectionStringBuilder

Public Sub New (connectionString As String)

Parametry

connectionString

String

Základ pro interní informace o připojení objektu. Parsuje se do párů klíč/hodnota.

Výjimky

ArgumentException

Připojovací řetězec je nesprávně formátovaný (možná chybí požadovaný "=" v páru klíč/hodnota).

Příklady

Následující příklad vytvoří více OleDbConnectionStringBuilder instancí a v každém případě předá konstruktoru jiný připojovací řetězec. Všimněte si, jak nastavení zprostředkovatele přidruženého k připojení změní sadu předdefinovaných párů klíč/hodnota v rámci kolekce objektu.

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()
    {
        try
        {
            // Build an empty instance, just to see
            // the contents of the keys.
            DumpBuilderContents("");

            // Create a SQL Server connection string.
            DumpBuilderContents("Provider=sqloledb;Data Source=(local);" +
                "Initial Catalog=AdventureWorks;" +
                "User Id=ab;Password=Password@1");

            // Create an Access connection string.
            DumpBuilderContents("Provider=Microsoft.Jet.OLEDB.4.0;" +
                @"Data Source=C:\Sample.mdb");

            // Create an Oracle connection string.
            DumpBuilderContents("Provider=msdaora;Data Source=SomeOracleDb;" +
                "User Id=userName;Password=Pass@word1;");

            // Create an Sybase connection string.
            DumpBuilderContents("Provider=ASAProv;Data source=myASA");

            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();
        }
        catch (System.ArgumentException ex)
        {

            Console.WriteLine("Error: " + ex.Message);
        }
    }

    private static void DumpBuilderContents(string connectString)
    {
        OleDbConnectionStringBuilder builder =
            new OleDbConnectionStringBuilder(connectString);
        Console.WriteLine("=================");
        Console.WriteLine("Original connectString   = " + connectString);
        Console.WriteLine("builder.ConnectionString = " + builder.ConnectionString);
        foreach (string key in builder.Keys)
        {
            Console.WriteLine(key + "=" + builder[key].ToString());
        }
    }
}

Imports System.Data.OleDb    

Module Module1
  Sub Main()
    Try
      ' Build an empty instance, just to see
      ' the contents of the keys.
      DumpBuilderContents("")

      ' Create a SQL Server connection string.
      DumpBuilderContents("Provider=sqloledb;Data Source=(local);" & _
       "Initial Catalog=AdventureWorks;" & _
       "User Id=ab;Password=Password@1")

      ' Create an Access connection string.
      DumpBuilderContents("Provider=Microsoft.Jet.OLEDB.4.0;" & _
       "Data Source=C:\Sample.mdb")

      ' Create an Oracle connection string.
      DumpBuilderContents("Provider=msdaora;Data Source=SomeOracleDb;" & _
       "User Id=userName;Password=Pass@word1;")

      ' Create a Sybase connection string.
      DumpBuilderContents("Provider=ASAProv;Data source=myASA")

      Console.WriteLine("Press any key to finish.")
      Console.ReadLine()

    Catch ex As System.ArgumentException
      Console.WriteLine("Error: " & ex.Message)
    End Try
  End Sub

  Private Sub DumpBuilderContents(ByVal connectString As String)
    Dim builder As New OleDbConnectionStringBuilder(connectString)
    Console.WriteLine("=================")
    Console.WriteLine("Original connectString   = " & connectString)
    Console.WriteLine("builder.ConnectionString = " & builder.ConnectionString)
    For Each key As String In builder.Keys
      Console.WriteLine(key & "=" & builder.Item(key).ToString)
    Next
  End Sub
End Module

Poznámky

Provider Nastavení vlastnosti, a to buď přímo (nastavením ConnectionString vlastnosti), nebo předáním připojovací řetězec jako parametru konstruktoru, může ovlivnit sadu párů klíč/hodnota obsažených v OleDbConnectionStringBuilder instanci. Provider Nastavením vlastnosti na "sqloledb" se například přidají všechny standardní vlastnosti SQL připojovací řetězec. Ukázku tohoto chování najdete v příkladu v tomto tématu.

U některých zprostředkovatelů přiřazení připojovací řetězec v rámci OleDbConnectionStringBuilder konstruktoru způsobí, že pořadí zadaných párů klíč/hodnota se přeuspořádá.

Viz také

• Tvůrci připojovacích řetězců
• Připojovací řetězce v ADO.NET