SqlConnectionStringBuilder.Item[String] Propiedad

Definición

Espacio de nombres:
System.Data.SqlClient
Ensamblado:
System.Data.SqlClient.dll
Ensamblado:
System.Data.dll
Source:
System.Data.SqlClient.notsupported.cs

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

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

Intentó agregar una clave que no existe dentro de las claves disponibles.

FormatException

Valor no válido dentro del cadena de conexión (en concreto, se esperaba un valor booleano o numérico, pero no proporcionado).

Ejemplos

El código siguiente, en una aplicación de consola, crea una nueva y agrega pares clave-valor a su cadena de conexión, mediante la propiedad /> 

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

SqlConnectionStringBuilder Dado que contiene un diccionario de tamaño fijo, al intentar agregar una clave que no existe en el diccionario se produce una KeyNotFoundExceptionexcepción .

Se aplica a

Consulte también