SqlConnectionStringBuilder Konstruktory

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.dll

Inicializuje novou instanci SqlConnectionStringBuilder třídy.

Přetížení

SqlConnectionStringBuilder()	Inicializuje novou instanci SqlConnectionStringBuilder třídy.
SqlConnectionStringBuilder(String)	Inicializuje novou instanci SqlConnectionStringBuilder třídy. Poskytnutá připojovací řetězec poskytuje data pro informace o interním připojení instance.

SqlConnectionStringBuilder()

Inicializuje novou instanci SqlConnectionStringBuilder třídy.

public:
 SqlConnectionStringBuilder();

public SqlConnectionStringBuilder ();

Public Sub New ()

Viz také

• Přehled ADO.NET

SqlConnectionStringBuilder(String)

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

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

public SqlConnectionStringBuilder (string connectionString);

new System.Data.SqlClient.SqlConnectionStringBuilder : string -> System.Data.SqlClient.SqlConnectionStringBuilder

Public Sub New (connectionString As String)

Parametry

connectionString

String

Základ pro informace o interním připojení objektu. Parsuje se do párů název/hodnota. Neplatné názvy klíčů vyvolávají .KeyNotFoundException

Výjimky

KeyNotFoundException

Neplatný název klíče v rámci připojovací řetězec.

FormatException

Neplatná hodnota v rámci připojovací řetězec (konkrétně pokud se očekávala logická nebo číselná hodnota, ale nebyla zadána).

ArgumentException

Zadaný argument connectionString není platný.

Příklady

Následující příklad poskytuje jednoduchý SQL Server připojovací řetězec v konstruktoru objektu SqlConnectionStringBuilder a pak iteruje všechny páry klíč/hodnota v objektu. Všimněte si, že kolekce poskytuje výchozí hodnoty pro každou položku. Všimněte si také, že SqlConnectionStringBuilder třída převádí synonyma pro dobře známé klíče tak, aby byly konzistentní s dobře známými názvy.

Poznámka

Tento příklad obsahuje heslo, které ukazuje, jak SqlConnectionStringBuilder 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.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Server=(local);Database=AdventureWorks;UID=ab;Pwd= a!Pass@@";
            Console.WriteLine("Original: " + connectString);
            SqlConnectionStringBuilder builder =
                new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Modified: " + builder.ConnectionString);
            foreach (string key in builder.Keys)
                Console.WriteLine(key + "=" + builder[key].ToString());
            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();
        }
        catch (System.Collections.Generic.KeyNotFoundException ex)
        {
            Console.WriteLine("KeyNotFoundException: " + ex.Message);
        }
        catch (System.FormatException ex)
        {
            Console.WriteLine("Format exception: " + ex.Message);
        }
    }
}

Imports System.Data.SqlClient

Module Module1
    Sub Main()
        Try
            Dim connectString As String = _
                "Server=(local);Database=AdventureWorks;UID=ab;Pwd=a!Pass@@"
            Console.WriteLine("Original: " & connectString)
            Dim builder As New SqlConnectionStringBuilder(connectString)
            Console.WriteLine("Modified: " & builder.ConnectionString)
            For Each key As String In builder.Keys
                Console.WriteLine(key & "=" & builder.Item(key).ToString)
            Next
            Console.WriteLine("Press any key to finish.")
            Console.ReadLine()

        Catch ex As System.Collections.Generic.KeyNotFoundException
            Console.WriteLine("KeyNotFoundException: " & ex.Message)
        Catch ex As System.FormatException
            Console.WriteLine("Format exception: " & ex.Message)
        End Try
    End Sub
End Module

Poznámky

Třída SqlConnectionStringBuilder poskytuje pevnou interní kolekci párů klíč/hodnota. I když zadáte pouze malou podmnožinu možných připojovací řetězec hodnot v konstruktoru, objekt vždy poskytuje výchozí hodnoty pro každou dvojici klíč/hodnota. Při načtení ConnectionString vlastnosti objektu obsahuje řetězec pouze páry klíč/hodnota, ve kterých hodnota není výchozí hodnotou položky.

Viz také

• Připojovací řetězce (ADO.NET)
• Přehled ADO.NET