SqlConnectionStringBuilder.Item[String] Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta il valore associato alla chiave specificata. In C# questa proprietà è l'indicizzatore.
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 ObjectParametri
- keyword
- String
Chiave dell'elemento da ottenere o impostare.
Valore della proprietà
Valore associato alla chiave specificata.
Eccezioni
keyword è un riferimento null (Nothing in Visual Basic).
È stato effettuato il tentativo di aggiungere una chiave che non esiste tra quelle disponibili.
Valore non valido nella stringa di connessione. Più specificamente, era previsto un valore booleano o numerico che non è stato fornito.
Esempio
Il seguente codice, in un'applicazione della console, crea un nuovo SqlConnectionStringBuilder e aggiunge coppie chiave/valore alla stringa di connessione, con la proprietà 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();
}
}
Commenti
Poiché l'oggetto SqlConnectionStringBuilder contiene un dizionario di dimensioni fisse, il tentativo di aggiungere una chiave che non esiste nel dizionario genera un'eccezione KeyNotFoundException.