SqlConnectionStringBuilder.Item[String] Propriété
Définition
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, setDefault Public Overrides Property Item(keyword As String) As ObjectParamètres
- keyword
- String
Clé de l'élément à obtenir ou définir.
Valeur de propriété
Valeur associée à la clé spécifiée.
Exceptions
keyword est une référence Null (Nothing en Visual Basic).
Une tentative d'ajout d'une clé qui ne figure pas parmi les clés disponibles a été effectuée.
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[].
using Microsoft.Data.SqlClient;
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();
}
}
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.