DbConnectionStringBuilder.Item[String] Propiedad

Definición

Espacio de nombres:

System.Data.Common

Ensamblado:

System.Data.Common.dll

Source:

DbConnectionStringBuilder.cs

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); };

[System.ComponentModel.Browsable(false)]
public virtual object this[string keyword] { 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 devuelve una referencia nula (Nothing en Visual Basic) y al intentar establecerla se crea un nuevo elemento con la clave especificada.

Al pasar una clave nula (Nothing en Visual Basic), se lanza una ArgumentNullException. Al asignar un valor nulo, se quita el par clave/valor.

Atributos

BrowsableAttribute

Excepciones

ArgumentNullException

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

NotSupportedException

La propiedad está establecida y DbConnectionStringBuilder es de solo lectura.

o bien

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

Ejemplos

La siguiente aplicación de consola crea un nuevo DbConnectionStringBuilder y agrega pares clave-valor a su cadena de conexión, mediante la Item[] propiedad .

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.

Consulte también

• Cadenas de conexión de ADO.NET
• Información general de ADO.NET