SqlConnectionStringBuilder.Item[String] Proprietà

Definizione

Spazio dei nomi:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacchetto:

Microsoft.Data.SqlClient v5.2.0

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, set

Default Public Overrides Property Item(keyword As String) As Object

Parametri

keyword

String

Chiave dell'elemento da ottenere o impostare.

Valore della proprietà

Object

Valore associato alla chiave specificata.

Eccezioni

ArgumentNullException

keyword è un riferimento null (Nothing in Visual Basic).

KeyNotFoundException

È stato effettuato il tentativo di aggiungere una chiave che non esiste tra quelle disponibili.

FormatException

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.