DbConnectionStringBuilder.Add(String, Object) Méthode

Définition

Espace de noms:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DbConnectionStringBuilder.cs

Ajoute une entrée avec la clé et la valeur spécifiées dans DbConnectionStringBuilder.

public:
 void Add(System::String ^ keyword, System::Object ^ value);

public void Add (string keyword, object value);

member this.Add : string * obj -> unit

Public Sub Add (keyword As String, value As Object)

Paramètres

keyword

String

Clé à ajouter à DbConnectionStringBuilder.

value

Object

Valeur de la clé spécifiée.

Exceptions

ArgumentNullException

keyword est une référence Null (Nothing en Visual Basic).

NotSupportedException

DbConnectionStringBuilder est en lecture seule.

- ou -

DbConnectionStringBuilder est de taille fixe.

Exemples

L’exemple suivant crée un nouveau DbConnectionStringBuilder et ajoute des éléments. Le code montre également le remplacement d’un élément existant à l’aide de la Add méthode , et inclut un bloc commenté qui lèverait un ArgumentNullException.

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()
{
    try
    {
        DbConnectionStringBuilder builder =
            new DbConnectionStringBuilder();
        builder.Add("Data Source", "ServerName");
        builder.Add("Initial Catalog", "TheDatabase");
        builder.Add("User ID", "UserName");
        builder.Add("Password", "*******");
        builder.Add("Command Logging", false);

        // Overwrite the existing "User ID" value.
        builder.Add("User ID", "NewUserName");

        // The following code would trigger
        // an ArgumentNullException:
        // builder.Add(null, "Some Value");

        Console.WriteLine(builder.ConnectionString);
    }
    catch (ArgumentNullException)
    {
        Console.WriteLine("Null key values are not allowed.");
    }

    Console.WriteLine("Press Enter to continue.");
    Console.ReadLine();
}

Sub Main()
    Try
        Dim builder As New DbConnectionStringBuilder
        builder.Add("Data Source", "ServerName")
        builder.Add("Initial Catalog", "TheDatabase")
        builder.Add("User ID", "UserName")
        builder.Add("Password", "*******")
        builder.Add("Command Logging", False)

        ' Overwrite the existing "User ID" value.
        builder.Add("User ID", "NewUserName")

        ' The following code would trigger 
        ' an ArgumentNullException.
        ' builder.Add(Nothing, "Some Value")

        Console.WriteLine(builder.ConnectionString)

    Catch ex As ArgumentNullException
        Console.WriteLine("Null key values are not allowed.")
    End Try

    Console.WriteLine("Press Enter to continue.")
    Console.ReadLine()
End Sub

Remarques

La Item[] propriété peut également être utilisée pour ajouter de nouveaux éléments en définissant la valeur d’une clé qui n’existe pas dans le dictionnaire. Par exemple : myCollection["myNonexistentKey"] = myValue.

L’appel de la Add méthode en passant une clé null (Nothing en Visual Basic) lève un ArgumentNullException. Toutefois, l’appel de la Add méthode en passant une valeur null supprime la paire clé/valeur.

Voir aussi

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