Partager via


SqlConnectionStringBuilder Constructeurs

Définition

Surcharges

SqlConnectionStringBuilder()

Initialise une nouvelle instance de la classe SqlConnectionStringBuilder.

SqlConnectionStringBuilder(String)

Initialise une nouvelle instance de la classe SqlConnectionStringBuilder. La chaîne de connexion spécifiée fournit les données pour les informations de connexion internes de l'instance.

SqlConnectionStringBuilder()

Initialise une nouvelle instance de la classe SqlConnectionStringBuilder.

public:
 SqlConnectionStringBuilder();
public SqlConnectionStringBuilder ();
Public Sub New ()

S’applique à

SqlConnectionStringBuilder(String)

Initialise une nouvelle instance de la classe SqlConnectionStringBuilder. La chaîne de connexion spécifiée fournit les données pour les informations de connexion internes de l'instance.

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)

Paramètres

connectionString
String

Base pour les informations de connexion internes de l'objet. Analysée dans les paires nom/valeur. Les noms de clés non valides déclenchent KeyNotFoundException.

Exceptions

Nom de clé non valide dans la chaîne de connexion.

Valeur non valide dans la chaîne de connexion (plus précisément, une valeur booléenne ou numérique était attendue, mais n'a pas été fournie).

connectionString n'est pas valide.

Exemples

L'exemple suivant fournit une chaîne de connexion SQL Server simple dans le constructeur de l'objet SqlConnectionStringBuilder, puis itère au sein de toute les paires clé/valeur dans l'objet. Notez que la collection fournit des valeurs par défaut pour chaque élément. Notez également que la classe SqlConnectionStringBuilder convertit les synonymes pour les clés connues de façon à ce qu'ils soient cohérents avec les noms connus.

Notes

Cet exemple inclut un mot de passe pour illustrer l'utilisation de SqlConnectionStringBuilder 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.

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);
        }
    }
}

Remarques

La classe SqlConnectionStringBuilder fournit une collection interne fixe de paires clé/valeur. Même si vous ne fournissez qu'un petit sous-ensemble des valeurs de chaînes de connexion possibles dans le constructeur, l'objet fournit toujours des valeurs par défaut aux paires clé/valeur. Lorsque la ConnectionString propriété de l’objet est récupérée, la chaîne contient uniquement des paires clé/valeur dans lesquelles la valeur n’est pas la valeur par défaut de l’élément.

S’applique à