DbConnectionStringBuilder.Item[String] Propriété

Définition

Espace de noms:
System.Data.Common
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

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); };
public virtual object this[string keyword] { get; set; }
[System.ComponentModel.Browsable(false)]
public virtual object this[string keyword] { get; set; }
member this.Item(string) : obj with 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, essayez de l’obtenir lève un ArgumentExceptionélément et essayez de le définir à l’aide de la clé spécifiée.

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

Attributs
BrowsableAttribute

Exceptions

ArgumentException

La valeur pour laquelle keyword elle n’a pas été définie dans la collection.

ArgumentNullException

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

NotSupportedException

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

-ou-

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

Exemples

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

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

S’applique à

Voir aussi