DbConnectionStringBuilder.ConnectionString Właściwość

Definicja

Przestrzeń nazw:

System.Data.Common

Zestaw:

System.Data.Common.dll

Źródło:

DbConnectionStringBuilder.cs

Pobiera lub ustawia parametry połączenia skojarzone z elementem DbConnectionStringBuilder.

public:
 property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

public string ConnectionString { get; set; }

member this.ConnectionString : string with get, set

Public Property ConnectionString As String

Wartość właściwości

String

Bieżąca parametry połączenia utworzona na podstawie par klucz/wartość, które znajdują się w obiekcie DbConnectionStringBuilder. Wartością domyślną jest ciąg pusty.

Wyjątki

ArgumentException

Podano nieprawidłowy argument parametry połączenia.

Przykłady

W poniższym przykładzie przedstawiono możliwe zachowania ConnectionString właściwości. Przykład:

• Tworzy parametry połączenia przez dodanie par klucz/wartość pojedynczo do pustego DbConnectionStringBuilderelementu .

• Przypisuje pełną parametry połączenia do ConnectionString właściwości DbConnectionStringBuilder wystąpienia i modyfikuje jedną parę klucz/wartość w ciągu.

• Przypisuje dowolny zestaw par klucz/wartość do ConnectionString właściwości (czyli ciąg, który nie jest niczym zdalnym jak parametry połączenia) i modyfikuje jedną z wartości.

• Przypisuje nieprawidłową parametry połączenia do ConnectionString właściwości, demonstrując zgłoszony wyjątek.

Uwaga

Ten przykład zawiera hasło do zademonstrowania DbConnectionStringBuilder 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.

static void Main()
{
    // Create a new DbConnctionStringBuilder, and add items
    // to the internal collection of key/value pairs.
    DbConnectionStringBuilder builder = new
        DbConnectionStringBuilder();
    builder.Add("Data Source", @"c:\MyData\MyDb.mdb");
    builder.Add("Provider", "Microsoft.Jet.Oledb.4.0");
    builder.Add("Jet OLEDB:Database Password", "********");
    builder.Add("Jet OLEDB:System Database",
        @"c:\MyData\Workgroup.mdb");

    // Set up row-level locking.
    builder.Add("Jet OLEDB:Database Locking Mode", 1);
    // Display the contents of the connection string, which
    // will now contain all the key/value pairs delimited with
    // semicolons.
    Console.WriteLine(builder.ConnectionString);
    Console.WriteLine();
    // Clear the DbConnectionStringBuilder, and assign a complete
    // connection string to it, to demonstrate how
    // the class parses connection strings.
    builder.Clear();
    builder.ConnectionString =
        "Data Source=(local);Initial Catalog=AdventureWorks;"
        + "Integrated Security=SSPI";
    // The DbConnectionStringBuilder class has parsed the contents,
    // so you can work with any individual key/value pair.
    builder["Data Source"] = ".";
    Console.WriteLine(builder.ConnectionString);
    Console.WriteLine();
    // Because the DbConnectionStringBuilder class doesn't
    // validate its key/value pairs, you can use this class
    // to store any semicolon-delimited list. The following
    // snippet places an arbitrary string into the ConnectionString
    // property, changes one of the values, and then displays the
    // resulting string.
    builder.Clear();
    builder.ConnectionString =
        "Value1=10;Value2=20;Value3=30;Value4=40";
    builder["Value2"] = 25;
    Console.WriteLine(builder.ConnectionString);
    Console.WriteLine();

    builder.Clear();
    try
    {
        // Assigning an invalid connection string
        // throws an ArgumentException.
        builder.ConnectionString = "xxx";
    }
    catch (ArgumentException)
    {
        Console.WriteLine("Invalid connection string.");
    }

    Console.WriteLine();
    Console.WriteLine("Press Enter to finish.");
    Console.ReadLine();
}

Sub Main()
    ' Create a new DbConnctionStringBuilder, and add items
    ' to the internal collection of key/value pairs.
    Dim builder As New DbConnectionStringBuilder()
    builder.Add("Data Source", "c:\MyData\MyDb.mdb")
    builder.Add("Provider", "Microsoft.Jet.Oledb.4.0")
    builder.Add("Jet OLEDB:Database Password", "*******")
    builder.Add("Jet OLEDB:System Database", _
        "c:\MyData\Workgroup.mdb")
    ' Set up row-level locking.
    builder.Add("Jet OLEDB:Database Locking Mode", 1)

    ' Display the contents of the connection string, which
    ' will now contain all the key/value pairs delimited with
    ' semicolons.
    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()

    ' Clear the DbConnectionStringBuilder, and assign a complete
    ' connection string to it, to demonstrate how
    ' the class parses connection strings.
    builder.Clear()
    builder.ConnectionString = _
        "Data Source=(local);Initial Catalog=AdventureWorks;" & _
        "Integrated Security=SSPI"

    ' The DbConnectionStringBuilder class has parsed the contents, 
    ' so you can work with any individual key/value pair.
    builder("Data Source") = "."
    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()

    ' Because the DbConnectionStringBuilder class doesn't 
    ' validate its key/value pairs, you can use this class
    ' to store any semicolon-delimited list. The following
    ' snippet places an arbitrary string into the ConnectionString
    ' property, changes one of the values, and then displays the
    ' resulting string.
    builder.Clear()
    builder.ConnectionString = _
        "Value1=10;Value2=20;Value3=30;Value4=40"
    builder("Value2") = 25
    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()

    builder.Clear()
    Try
        ' Assigning an invalid connection string
        ' throws an ArgumentException.
        builder.ConnectionString = "xxx"

    Catch ex As ArgumentException
        Console.WriteLine("Invalid connection string.")
    End Try

    Console.WriteLine()
    Console.WriteLine("Press Enter to finish.")
    Console.ReadLine()
End Sub

Uwagi

Ta właściwość zwraca rozdzieloną średnikami listę par klucz/wartość przechowywanych w kolekcji obsługiwanej DbConnectionStringBuilderprzez element . Każda para zawiera klucz i wartość oddzieloną znakiem równości. Poniższy przykład ilustruje typowy parametry połączenia.

"Persist Security Info=False;Integrated Security=SSPI;Initial Catalog=AdventureWorks;Data Source=(local)"

Dostawcy danych mogą oczekiwać określonych kluczy i wartości dla każdej właściwości parametry połączenia. , Te wartości są udokumentowane indywidualnie. Klasa DbConnectionStringBuilder nie weryfikuje par klucz/wartość skojarzonych z jej parametry połączenia, chociaż klasy dziedziczone z niej mogą.

Właściwość ConnectionStringDbConnectionStringBuilder klasy działa ogólnie jako mechanizm tworzenia i analizowania rozdzielanych średnikami list par klucz/wartość oddzielonych znakami. Nie zapewnia weryfikacji ani innego wsparcia specyficznego dla parametrów połączenia. Jeśli dodasz elementy do DbConnectionStringBuilder kolekcji, ConnectionString właściwość będzie odzwierciedlać zmiany. Jeśli przypiszesz wartość do ConnectionString właściwości, DbConnectionStringBuilder funkcja spróbuje przeanalizować wartość przy użyciu średnika i ograniczników znaku równości.

Zobacz też

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