SqlConnectionStringBuilder Konstruktory

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

Przeciążenia

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

SqlConnectionStringBuilder()

Inicjuje nowe wystąpienie klasy SqlConnectionStringBuilder.

public:
 SqlConnectionStringBuilder();

public SqlConnectionStringBuilder ();

Public Sub New ()

SqlConnectionStringBuilder(String)

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

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

public SqlConnectionStringBuilder (string connectionString);

new Microsoft.Data.SqlClient.SqlConnectionStringBuilder : string -> Microsoft.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 parametrach połączenia.

FormatException

Nieprawidłowa wartość w parametrach połączenia (w szczególności wtedy, 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 parametry połączenia SQL Server 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 Microsoft.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);
        }
    }
}

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 parametrów 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.