SqlConnectionStringBuilder.Item[String] Propriété

Référence

Définition

Espace de noms:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Paquet:: System.Data.SqlClient v4.8.6

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit la valeur associée à la clé spécifiée. En C#, cette propriété est l'indexeur.

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

public override object this[string keyword] { get; set; }

member this.Item(string) : obj with get, set

Default Public Overrides 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.

Exceptions

ArgumentNullException

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

KeyNotFoundException

Une tentative d'ajout d'une clé qui ne figure pas parmi les clés disponibles a été effectuée.

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

Exemples

Le code suivant, dans une application console, crée un SqlConnectionStringBuilder et ajoute des paires clé/valeur à sa chaîne de connexion, à l'aide de la propriété Item[].

class Program
{
    static void Main()
    {
        SqlConnectionStringBuilder builder =
            new SqlConnectionStringBuilder();
        builder["Data Source"] = "(local)";
        builder["Integrated Security"] = true;
        builder["Initial Catalog"] = "AdventureWorks";

        // Overwrite the existing value for the Data Source value.
        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 SqlConnectionStringBuilder
        builder.Item("Data Source") = "(local)"
        ' Item is the default property, so 
        ' you needn't include it in the reference.
        builder("Integrated Security") = True
        builder.Item("Initial Catalog") = "AdventureWorks"

        ' Overwrite the existing value for the Data Source value.
        builder.Item("Data Source") = "."

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

Remarques

Dans la mesure où SqlConnectionStringBuilder contient un dictionnaire de taille fixe, la tentative d'ajout d'une clé qui n'existe pas dans le dictionnaire lève une exception KeyNotFoundException.

S’applique à