SqlConnectionStringBuilder.Item[String] Propriété

Définition

Espace de noms:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
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 dans Visual Basic).

KeyNotFoundException

Essayez d’ajouter une clé qui n’existe pas dans les clés disponibles.

FormatException

Valeur non valide dans le chaîne de connexion (en particulier, une valeur booléenne ou numérique était attendue, mais non fournie).

Exemples

Le code suivant, dans une application console, crée une nouvelle SqlConnectionStringBuilder et ajoute des paires clé/valeur à son 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

Comme le SqlConnectionStringBuilder dictionnaire contient un dictionnaire de taille fixe, la tentative d’ajout d’une clé qui n’existe pas dans le dictionnaire lève un KeyNotFoundException.

S’applique à

Voir aussi