DbConnectionStringBuilder.Item[String] Propiedad

Definición

Espacio de nombres:
System.Data.Common
Ensamblado:
System.Data.Common.dll
Ensamblado:
System.Data.dll
Ensamblado:
netstandard.dll

Obtiene o establece el valor asociado a la clave 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

Clave del elemento que se va a obtener o establecer.

Valor de propiedad

Object

Valor asociado a la clave especificada. Si no se encuentra la clave especificada, al intentar obtenerla se produce un ArgumentExceptiony se intenta establecer se crea un nuevo elemento mediante la clave especificada.

Pasar una clave nula (Nothing en Visual Basic) produce una ArgumentNullException. La asignación de un valor NULL quita el par clave-valor.

Atributos
BrowsableAttribute

Excepciones

ArgumentException

El valor de keyword no se ha establecido en la colección.

ArgumentNullException

keyword es una referencia nula (Nothing en Visual Basic).

NotSupportedException

La propiedad se establece y es de DbConnectionStringBuilder solo lectura.

O bien

La propiedad se establece, keyword no existe en la colección y DbConnectionStringBuilder tiene un tamaño fijo.

Ejemplos

La siguiente aplicación de consola crea una nueva DbConnectionStringBuilder y agrega pares clave-valor a su cadena de conexión, mediante la propiedad 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

Comentarios

Al establecer esta propiedad, si la clave especificada ya existe en el diccionario, el valor se reemplaza; De lo contrario, se crea un nuevo elemento.

Se aplica a

Consulte también