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.9.0
Source:
System.Data.SqlClient.notsupported.cs

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 à

Voir aussi