SqlConnectionStringBuilder.Item[String] Propiedad

Referencia

Definición

Espacio de nombres:: System.Data.SqlClient

Ensamblado:: System.Data.SqlClient.dll

Ensamblado:: System.Data.dll

Ensamblados:: netstandard.dll, System.Data.SqlClient.dll

Paquete:: System.Data.SqlClient v4.8.6

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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[].

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

Module Module1
    Sub Main()
        Dim builder As New SqlConnectionStringBuilder
        builder.Item("Data Source") = "(local)"
        ' Item is the default property, so 
        ' you needn't include it in the reference.
        builder("Integrated Security") = True
        builder.Item("Initial Catalog") = "AdventureWorks"

        ' Overwrite the existing value for the Data Source value.
        builder.Item("Data Source") = "."

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

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.

Se aplica a

Compartir vía