SqlConnectionStringBuilder Construtores

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

Sobrecargas

SqlConnectionStringBuilder()	Inicializa uma nova instância da classe SqlConnectionStringBuilder.
SqlConnectionStringBuilder(String)	Inicializa uma nova instância da classe SqlConnectionStringBuilder. A cadeia de conexão fornecida oferece os dados para obter informações de conexão internas da instância.

SqlConnectionStringBuilder()

Inicializa uma nova instância da classe SqlConnectionStringBuilder.

public:
 SqlConnectionStringBuilder();

public SqlConnectionStringBuilder ();

Public Sub New ()

SqlConnectionStringBuilder(String)

Inicializa uma nova instância da classe SqlConnectionStringBuilder. A cadeia de conexão fornecida oferece os dados para obter informações de conexão internas da instância.

public:
 SqlConnectionStringBuilder(System::String ^ connectionString);

public SqlConnectionStringBuilder (string connectionString);

new Microsoft.Data.SqlClient.SqlConnectionStringBuilder : string -> Microsoft.Data.SqlClient.SqlConnectionStringBuilder

Public Sub New (connectionString As String)

Parâmetros

connectionString

String

A base das informações de conexão internas do objeto. Analisado em pares nome/valor. Nomes de chave inválidos geram KeyNotFoundException.

Exceções

KeyNotFoundException

Nome de chave inválido na cadeia de conexão.

FormatException

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

ArgumentException

A connectionString fornecida não é válida.

Exemplos

O exemplo a seguir fornece uma cadeia de conexão SQL Server simples no SqlConnectionStringBuilder construtor do objeto e itera todos os pares chave/valor dentro do objeto. Observe que a coleção fornece valores padrão para cada item. Observe também que a SqlConnectionStringBuilder classe converte sinônimos para as chaves conhecidas para que sejam consistentes com os nomes conhecidos.

Observação

Este exemplo inclui uma senha para demonstrar como SqlConnectionStringBuilder funciona com cadeias de conexão. Em seus aplicativos, recomendamos que você use a Autenticação do Windows. Se você precisar usar uma senha, não inclua uma senha codificada em código em seu aplicativo.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Server=(local);Database=AdventureWorks;UID=ab;Pwd= a!Pass@@";
            Console.WriteLine("Original: " + connectString);
            SqlConnectionStringBuilder builder =
                new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Modified: " + builder.ConnectionString);
            foreach (string key in builder.Keys)
                Console.WriteLine(key + "=" + builder[key].ToString());
            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();

        }
        catch (System.Collections.Generic.KeyNotFoundException ex)
        {
            Console.WriteLine("KeyNotFoundException: " + ex.Message);
        }
        catch (System.FormatException ex)
        {
            Console.WriteLine("Format exception: " + ex.Message);
        }
    }
}

Comentários

A SqlConnectionStringBuilder classe fornece uma coleção interna fixa de pares chave/valor. Mesmo que você forneça apenas um pequeno subconjunto dos possíveis valores de cadeia de conexão no construtor, o objeto sempre fornece valores padrão para cada par chave/valor. Quando a ConnectionString propriedade do objeto é recuperada, a cadeia de caracteres contém apenas pares chave/valor em que o valor não é o valor padrão para o item.