SqlConnectionStringBuilder Constructeurs

Définition

Espace de noms:

System.Data.SqlClient

Assembly:

System.Data.SqlClient.dll

Paquet:

System.Data.SqlClient v4.8.6

Initialise une nouvelle instance de la classe SqlConnectionStringBuilder.

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 ()

Voir aussi

• Vue d'ensemble d’ADO.NET

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 System.Data.SqlClient.SqlConnectionStringBuilder : string -> System.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

KeyNotFoundException

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

FormatException

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).

ArgumentException

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

Imports System.Data.SqlClient

Module Module1
    Sub Main()
        Try
            Dim connectString As String = _
                "Server=(local);Database=AdventureWorks;UID=ab;Pwd=a!Pass@@"
            Console.WriteLine("Original: " & connectString)
            Dim builder As New SqlConnectionStringBuilder(connectString)
            Console.WriteLine("Modified: " & builder.ConnectionString)
            For Each key As String In builder.Keys
                Console.WriteLine(key & "=" & builder.Item(key).ToString)
            Next
            Console.WriteLine("Press any key to finish.")
            Console.ReadLine()

        Catch ex As System.Collections.Generic.KeyNotFoundException
            Console.WriteLine("KeyNotFoundException: " & ex.Message)
        Catch ex As System.FormatException
            Console.WriteLine("Format exception: " & ex.Message)
        End Try
    End Sub
End Module

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.

Voir aussi

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