SqlConnectionStringBuilder.Item[String] Propriedade

Definição

Namespace:
System.Data.SqlClient
Assembly:
System.Data.dll

Obtém ou define o valor associado à chave especificada. Em C#, essa propriedade é o 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

A chave do item a ser obtido ou definido.

Valor da propriedade

Object

O valor associado à chave especificada.

Exceções

ArgumentNullException

keyword é uma referência nula (Nothing em Visual Basic).

KeyNotFoundException

Tentou adicionar uma chave que não existe dentro das chaves disponíveis.

FormatException

Valor inválido no cadeia de conexão (especificamente, um valor booliano ou numérico era esperado, mas não fornecido).

Exemplos

O código a seguir, em um aplicativo de console, cria um novo SqlConnectionStringBuilder e adiciona pares chave/valor à sua cadeia de conexão, usando a propriedade 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

Comentários

Como ele SqlConnectionStringBuilder contém um dicionário de tamanho fixo, tentar adicionar uma chave que não existe dentro do dicionário lança um KeyNotFoundException.

Aplica-se a

Confira também