DbConnectionStringBuilder.ConnectionString Propriété

Définition

Obtient ou définit la chaîne de connexion associée au DbConnectionStringBuilder.Gets or sets the connection string associated with the 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é

Chaîne de connexion actuelle, créée à partir des paires clé/valeur contenues dans le DbConnectionStringBuilder.The current connection string, created from the key/value pairs that are contained within the DbConnectionStringBuilder. La valeur par défaut est une chaîne vide.The default value is an empty string.

Exceptions

Un argument de chaîne de connexion non valide a été fourni.An invalid connection string argument has been supplied.

Exemples

L’exemple suivant illustre les comportements possibles de la propriété ConnectionString.The following example demonstrates possible behaviors of the ConnectionString property. L'exemple :The example:

  • Crée une chaîne de connexion en ajoutant des paires clé/valeur, une à la fois, à un DbConnectionStringBuildervide.Creates a connection string by adding key/value pairs, one at a time, to an empty DbConnectionStringBuilder.

  • Assigne une chaîne de connexion complète à la propriété ConnectionString de l’instance DbConnectionStringBuilder et modifie une paire clé/valeur unique dans la chaîne.Assigns a complete connection string to the ConnectionString property of the DbConnectionStringBuilder instance, and modifies a single key/value pair within the string.

  • Assigne un ensemble arbitraire de paires clé/valeur à la propriété ConnectionString (autrement dit, une chaîne qui n’est pas à distance comme une chaîne de connexion) et modifie l’une des valeurs.Assigns an arbitrary set of key/value pairs to the ConnectionString property (that is, a string that is not anything remotely like a connection string), and modifies one of the values.

  • Assigne une chaîne de connexion non valide à la propriété ConnectionString, en montrant l’exception levée.Assigns an invalid connection string to the ConnectionString property, demonstrating the exception that is thrown.

Notes

Cet exemple inclut un mot de passe pour illustrer l'utilisation de DbConnectionStringBuilder avec les chaînes de connexion.This example includes a password to demonstrate how DbConnectionStringBuilder works with connection strings. Dans vos applications, nous vous recommandons d'utiliser l'authentification Windows.In your applications, we recommend that you use Windows Authentication. Si vous devez utiliser un mot de passe, n'incluez pas de mot de passe codé en dur dans votre application.If you must use a password, do not include a hard-coded password in your 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 le DbConnectionStringBuilder.This property returns a semicolon-delimited list of key/value pairs stored within the collection maintained by the DbConnectionStringBuilder. Chaque paire contient la clé et la valeur, séparées par un signe égal.Each pair contains the key and value, separated by an equal sign. L’exemple suivant illustre une chaîne de connexion classique.The following example illustrates a typical connection string.

"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é de chaîne de connexion.Data providers may expect specific keys and values for each connection string property. , Ces valeurs sont documentées individuellement., These values are documented individually. La classe DbConnectionStringBuilder ne valide pas les paires clé/valeur associées à sa chaîne de connexion, bien que les classes qui héritent de celle-ci puissent.The DbConnectionStringBuilder class does not validate the key/value pairs associated with its connection string, although classes that inherit from it can.

La propriété ConnectionString de la classe DbConnectionStringBuilder agit généralement comme un mécanisme de création et d’analyse de listes délimitées par des points-virgules de paires clé/valeur séparées par des signes égal.The ConnectionString property of the DbConnectionStringBuilder class acts generally as a mechanism for creating and parsing semicolon-delimited lists of key/value pairs separated with equal signs. Il ne fournit aucune validation ou autre prise en charge spécifique aux chaînes de connexion.It provides no validation or other support specific to connection strings. Si vous ajoutez des éléments à la collection DbConnectionStringBuilder, la propriété ConnectionString reflète les modifications.If you add items to the DbConnectionStringBuilder collection, the ConnectionString property will reflect the changes. Si vous assignez une valeur à la propriété ConnectionString, la DbConnectionStringBuilder essaiera d’analyser la valeur, à l’aide des délimiteurs de point-virgule et de signe égal.If you assign a value to the ConnectionString property, the DbConnectionStringBuilder will try to parse the value, using the semicolon and equal-sign delimiters.

S’applique à

Voir aussi