SqlConnectionStringBuilder.Item[String] Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Pacchetto:: System.Data.SqlClient v4.8.6

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, 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[].

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

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.

Si applica a