DbConnectionStringBuilder.Item[String] Propriété

Définition

Espace de noms:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DbConnectionStringBuilder.cs

Obtient ou définit la valeur associée à la clé spécifiée.

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ keyword); void set(System::String ^ keyword, System::Object ^ value); };

[System.ComponentModel.Browsable(false)]
public virtual object this[string keyword] { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.Item(string) : obj with get, set

Default Public Overridable Property Item(keyword As String) As Object

Paramètres

keyword

String

Clé de l'élément à obtenir ou définir.

Valeur de propriété

Object

Valeur associée à la clé spécifiée. Si la clé spécifiée est introuvable, la tentative d’obtention retourne une référence null (Nothing en Visual Basic) et la tentative de définition crée un nouvel élément avec la clé spécifiée.

Le passage d’une valeur null (Nothing en Visual Basic) lève une exception ArgumentNullException. L’affectation d’une valeur null supprime la paire clé/valeur.

Attributs

BrowsableAttribute

Exceptions

ArgumentNullException

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

NotSupportedException

La propriété est définie et DbConnectionStringBuilder est en lecture seule.

- ou -

La propriété est définie, keyword n’existe pas dans la collection et DbConnectionStringBuilder a une taille fixe.

Exemples

L’application console suivante crée un nouveau DbConnectionStringBuilder et ajoute des paires clé/valeur à son chaîne de connexion, à l’aide de la Item[] propriété .

static void Main()
{
    DbConnectionStringBuilder builder = new
        DbConnectionStringBuilder();
    builder["Data Source"] = "(local)";

    // Note that Item is the indexer, so
    // you do not include it in the reference.
    builder["integrated security"] = true;
    builder["Initial Catalog"] = "AdventureWorks";

    // Overwrite the existing value for the Data Source key,
    // because it already exists within the collection.
    builder["Data Source"] = ".";

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

Module Module1

    Sub Main()
        Dim builder As New DbConnectionStringBuilder
        builder.Item("Data Source") = "(local)"

        ' Item is the default property, so 
        ' you need not include it in the reference.
        builder("integrated security") = True
        builder.Item("Initial Catalog") = "AdventureWorks"

        ' Overwrite the existing value for the data source value, 
        ' because it already exists within the collection.
        builder.Item("Data Source") = "."

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

Remarques

Lorsque vous définissez cette propriété, si la clé spécifiée existe déjà dans le dictionnaire, la valeur est remplacée ; sinon, un nouvel élément est créé.

Voir aussi

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