SqlConnectionStringBuilder.Item[String] Propriedade

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

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 .

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

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.