DbConnectionStringBuilder.Item[String] Propriedade

Definição

Espaço de Nomes:
System.Data.Common
Assemblagem:
System.Data.Common.dll
Assemblagem:
System.Data.dll
Assemblagem:
netstandard.dll

Obtém ou define o valor associado à chave especificada.

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

Parâmetros

keyword
String

A chave do item a obter ou definir.

Valor de Propriedade

Object

O valor associado à chave especificada. Se a chave especificada não for encontrada, tentar obtê-la gera um ArgumentException, e tentar defini-la cria um novo elemento usando a chave especificada.

Passar uma tecla nula (Nothing em Visual Basic) gera um ArgumentNullException. Atribuir um valor nulo remove o par chave/valor.

Atributos
BrowsableAttribute

Exceções

ArgumentException

O valor de keyword não foi definido na coleção.

ArgumentNullException

keyword é uma referência nula (Nothing em Visual Basic).

NotSupportedException

A propriedade está definida, e a DbConnectionStringBuilder é só de leitura.

-ou-

A propriedade é definida, keyword não existe na coleção, e tem DbConnectionStringBuilder um tamanho fixo.

Exemplos

A seguinte aplicação de consola cria um novo DbConnectionStringBuilder e adiciona pares chave/valor ao seu cadeia de ligação, usando a propriedade 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

Observações

Quando defines esta propriedade, se a chave especificada já existir no dicionário, o valor é substituído; caso contrário, é criado um novo elemento.

Aplica-se a

Ver também