SqlConnectionStringBuilder.Item[String] Propiedad

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

Obtiene o establece el valor asociado a la clave especificada. En C#, esta propiedad es el indizador.

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

Parámetros

keyword

String

Clave del elemento que se va a obtener o establecer.

Valor de propiedad

Object

Valor asociado a la clave especificada.

Excepciones

ArgumentNullException

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

KeyNotFoundException

Se ha intentado agregar una clave que no existe dentro del conjunto de claves disponibles.

FormatException

Valor no válido dentro de la cadena de conexión (concretamente cuando se esperaba un valor booleano o numérico, pero no se ha proporcionado).

Ejemplos

El siguiente código, en una aplicación de consola, crea una nueva SqlConnectionStringBuilder y agrega pares clave-valor a sus cadenas de conexión, utilizando la propiedad Item[].

using Microsoft.Data.SqlClient;

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

Comentarios

Dado que SqlConnectionStringBuilder contiene un diccionario de tamaño fijo, cualquier intento de agregar una clave que no exista en el diccionario producirá una excepción KeyNotFoundException.