DbConnectionStringBuilder.ConnectionString Propriété

Définition

Espace de noms:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DbConnectionStringBuilder.cs

Obtient ou définit la chaîne de connexion associée au 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

Valeur de propriété

String

Chaîne de connexion actuelle, créée à partir des paires clé/valeur contenues dans le DbConnectionStringBuilder. La valeur par défaut est une chaîne vide.

Exceptions

ArgumentException

Un argument de chaîne de connexion non valide a été fourni.

Exemples

L’exemple suivant illustre les comportements possibles de la ConnectionString propriété . L'exemple :

• Crée un chaîne de connexion en ajoutant des paires clé/valeur, une par une, à un videDbConnectionStringBuilder.

• Affecte une chaîne de connexion complète à la ConnectionString propriété du DbConnectionStringBuilder instance et modifie une paire clé/valeur unique dans la chaîne.

• Affecte un ensemble arbitraire de paires clé/valeur à la ConnectionString propriété (c’est-à-dire une chaîne qui n’est pas semblable à une chaîne de connexion) et modifie l’une des valeurs.

• Affecte une chaîne de connexion non valide à la ConnectionString propriété, montrant l’exception levée.

Notes

Cet exemple inclut un mot de passe pour illustrer l'utilisation de DbConnectionStringBuilder avec les chaînes de connexion. Dans vos applications, nous vous recommandons d'utiliser l'authentification Windows. Si vous devez utiliser un mot de passe, n'incluez pas de mot de passe codé en dur dans votre application.

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

Remarques

Cette propriété retourne une liste délimitée par des points-virgules de paires clé/valeur stockées dans la collection gérée par .DbConnectionStringBuilder Chaque paire contient la clé et la valeur, séparées par un signe égal. L’exemple suivant illustre une chaîne de connexion classique.

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

Les fournisseurs de données peuvent s’attendre à des clés et des valeurs spécifiques pour chaque propriété chaîne de connexion. , Ces valeurs sont documentées individuellement. La DbConnectionStringBuilder classe ne valide pas les paires clé/valeur associées à son chaîne de connexion, bien que les classes qui héritent de celle-ci le puissent.

La ConnectionString propriété de la DbConnectionStringBuilder classe agit généralement comme un mécanisme pour créer et analyser des listes délimitées par des points-virgules de paires clé/valeur séparées par des signes égaux. Il ne fournit aucune validation ou autre prise en charge spécifique aux chaînes de connexion. Si vous ajoutez des éléments à la DbConnectionStringBuilder collection, la ConnectionString propriété reflète les modifications. Si vous affectez une valeur à la ConnectionString propriété, le DbConnectionStringBuilder tente d’analyser la valeur à l’aide du point-virgule et des délimiteurs de signe égal.

Voir aussi

• Chaînes de connexion dans ADO.NET
• Vue d'ensemble d’ADO.NET