SqlConnectionStringBuilder Konstruktory

Definicja

Przestrzeń nazw:

System.Data.SqlClient

Zestaw:

System.Data.dll

Inicjuje nowe wystąpienie klasy SqlConnectionStringBuilder.

Przeciążenia

SqlConnectionStringBuilder()	Inicjuje nowe wystąpienie klasy SqlConnectionStringBuilder.
SqlConnectionStringBuilder(String)	Inicjuje nowe wystąpienie klasy SqlConnectionStringBuilder. Podany parametry połączenia dostarcza dane dla informacji o połączeniu wewnętrznym wystąpienia.

SqlConnectionStringBuilder()

Inicjuje nowe wystąpienie klasy SqlConnectionStringBuilder.

public:
 SqlConnectionStringBuilder();

public SqlConnectionStringBuilder ();

Public Sub New ()

Zobacz też

• Omówienie ADO.NET

SqlConnectionStringBuilder(String)

Inicjuje nowe wystąpienie klasy SqlConnectionStringBuilder. Podany parametry połączenia dostarcza dane dla informacji o połączeniu wewnętrznym wystąpienia.

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

Podstawa informacji o połączeniu wewnętrznym obiektu. Przeanalizowano pary nazw/wartości. Nieprawidłowe nazwy kluczy zgłaszają wartość KeyNotFoundException.

Wyjątki

KeyNotFoundException

Nieprawidłowa nazwa klucza w parametry połączenia.

FormatException

Nieprawidłowa wartość w parametry połączenia (w szczególności gdy oczekiwano wartości logicznej lub liczbowej, ale nie podano).

ArgumentException

Podany connectionString element jest nieprawidłowy.

Przykłady

W poniższym przykładzie przedstawiono proste SQL Server parametry połączenia w SqlConnectionStringBuilder konstruktorze obiektu, a następnie iteruje wszystkie pary klucz/wartość w obiekcie. Należy pamiętać, że kolekcja zawiera wartości domyślne dla każdego elementu. Należy również pamiętać, że SqlConnectionStringBuilder klasa konwertuje synonimy dla dobrze znanych kluczy, aby były zgodne z dobrze znanymi nazwami.

Uwaga

Ten przykład zawiera hasło do zademonstrowania SqlConnectionStringBuilder sposobu działania z parametrami połączenia. W aplikacjach zalecamy użycie uwierzytelniania systemu Windows. Jeśli musisz użyć hasła, nie dołączaj hasła zakodowanego w aplikacji.

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

Uwagi

Klasa SqlConnectionStringBuilder udostępnia stałą wewnętrzną kolekcję par klucz/wartość. Nawet jeśli w konstruktorze podano tylko mały podzbiór możliwych wartości parametry połączenia, obiekt zawsze udostępnia wartości domyślne dla każdej pary klucz/wartość. Po ConnectionString pobraniu właściwości obiektu ciąg zawiera tylko pary klucz/wartość, w których wartość nie jest wartością domyślną elementu.

Zobacz też

• Parametry połączenia (ADO.NET)
• Omówienie ADO.NET