DbConnectionStringBuilder.ConnectionString Proprietà

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DbConnectionStringBuilder.cs

Ottiene o imposta la stringa di connessione associata all'oggetto 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

Valore della proprietà

String

Stringa di connessione corrente, creata dalle coppie chiave/valore contenute all'interno dell'oggetto DbConnectionStringBuilder. Il valore predefinito è una stringa vuota.

Eccezioni

ArgumentException

È stato fornito un argomento non valido della stringa di connessione.

Esempio

Nell'esempio seguente vengono illustrati i possibili comportamenti della ConnectionString proprietà. Esempio:

• Crea un stringa di connessione aggiungendo coppie chiave/valore, una alla volta, a un oggetto vuotoDbConnectionStringBuilder.

• Assegna un stringa di connessione completo alla ConnectionString proprietà dell'istanza DbConnectionStringBuilder e modifica una singola coppia chiave/valore all'interno della stringa.

• Assegna un set arbitrario di coppie chiave/valore alla proprietà , ovvero una stringa che non è remotamente simile a ConnectionString un stringa di connessione, e modifica uno dei valori.

• Assegna un stringa di connessione non valido alla ConnectionString proprietà, che illustra l'eccezione generata.

Nota

In questo esempio è inclusa una password per dimostrare il funzionamento di DbConnectionStringBuilder con le stringhe di connessione. Nelle applicazioni, è consigliabile utilizzare Windows Authentication. Quando è necessario utilizzare una password, non includere password hardcoded nell'applicazione.

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

Commenti

Questa proprietà restituisce un elenco delimitato da punti e virgola di coppie chiave/valore archiviate all'interno della raccolta gestita da DbConnectionStringBuilder. Ogni coppia contiene la chiave e il valore, separati da un segno uguale. Nell'esempio seguente viene illustrato un stringa di connessione tipico.

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

I provider di dati possono prevedere chiavi e valori specifici per ogni proprietà stringa di connessione. , Questi valori sono documentati singolarmente. La DbConnectionStringBuilder classe non convalida le coppie chiave/valore associate alla relativa stringa di connessione, anche se le classi che ereditano da esso possono.

La ConnectionString proprietà della classe funge in genere da meccanismo per la creazione e l'analisi DbConnectionStringBuilder di elenchi delimitati da punti e virgola di coppie chiave/valore separate con segni uguali. Non fornisce alcuna convalida o altro supporto specifico per le stringhe di connessione. Se si aggiungono elementi alla DbConnectionStringBuilder raccolta, la ConnectionString proprietà rifletterà le modifiche. Se si assegna un valore alla ConnectionString proprietà, si DbConnectionStringBuilder tenterà di analizzare il valore usando il punto e virgola e i delimitatori di segno uguale.

Vedi anche

• Stringhe di connessione in ADO.NET
• Panoramica di ADO.NET