DbConnectionStringBuilder.Item[String] Proprietà

Definizione

Spazio dei nomi:
System.Data.Common
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Ottiene o imposta il valore associato alla chiave specificata.

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ keyword); void set(System::String ^ keyword, System::Object ^ value); };
public virtual object this[string keyword] { get; set; }
[System.ComponentModel.Browsable(false)]
public virtual object this[string keyword] { get; set; }
member this.Item(string) : obj with get, set
[<System.ComponentModel.Browsable(false)>]
member this.Item(string) : obj with get, set
Default Public Overridable 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. Se la chiave specificata non viene trovata, il tentativo di ottenerlo genera un'eccezione ArgumentExceptione tenta di impostarlo crea un nuovo elemento usando la chiave specificata.

Il passaggio di una chiave null (Nothing in Visual Basic) genera un'eccezione ArgumentNullException. L'assegnazione di un valore Null rimuove la coppia chiave/valore.

Attributi
BrowsableAttribute

Eccezioni

ArgumentException

Il valore per keyword non è stato impostato nell'insieme.

ArgumentNullException

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

NotSupportedException

La proprietà è impostata e è DbConnectionStringBuilder di sola lettura.

oppure

La proprietà è impostata, keyword non esiste nell'insieme e ha DbConnectionStringBuilder una dimensione fissa.

Esempio

L'applicazione console seguente crea un nuovo DbConnectionStringBuilder e aggiunge coppie chiave/valore al relativo stringa di connessione, usando la proprietà Item[].

static void Main()
{
    DbConnectionStringBuilder builder = new
        DbConnectionStringBuilder();
    builder["Data Source"] = "(local)";

    // Note that Item is the indexer, so
    // you do not include it in the reference.
    builder["integrated security"] = true;
    builder["Initial Catalog"] = "AdventureWorks";

    // Overwrite the existing value for the Data Source key,
    // because it already exists within the collection.
    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 DbConnectionStringBuilder
        builder.Item("Data Source") = "(local)"

        ' Item is the default property, so 
        ' you need not include it in the reference.
        builder("integrated security") = True
        builder.Item("Initial Catalog") = "AdventureWorks"

        ' Overwrite the existing value for the data source value, 
        ' because it already exists within the collection.
        builder.Item("Data Source") = "."

        Console.WriteLine(builder.ConnectionString)
        Console.WriteLine()
        Console.WriteLine("Press Enter to continue.")
        Console.ReadLine()
    End Sub

Commenti

Quando si imposta questa proprietà, se la chiave specificata esiste già nel dizionario, il valore viene sostituito; in caso contrario, viene creato un nuovo elemento.

Si applica a

Vedi anche