SqlConnectionStringBuilder.Item[String] Propriedade

  • Referência

Definição

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Pacote:
System.Data.SqlClient v4.8.6

Obtém ou define o valor associado à chave especificada. No 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 obtida ou definida.

Valor da propriedade

Object

O valor associado à chave especificada.

Exceções

ArgumentNullException

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

KeyNotFoundException

Ocorreu uma tentativa de adicionar uma chave que não existe nas chaves disponíveis.

FormatException

Valor inválido na cadeia de conexão (especificamente, quando um valor numérico ou booliano era esperado, mas não foi 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 Item[] propriedade .

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 o 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