SqlConnectionStringBuilder Construtores

Definição

Namespace:

System.Data.SqlClient

Assembly:

System.Data.SqlClient.dll

Pacote:

System.Data.SqlClient v4.8.6

Inicializa uma nova instância da classe SqlConnectionStringBuilder.

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

Confira também

• Visão geral do ADO.NET

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 System.Data.SqlClient.SqlConnectionStringBuilder : string -> System.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 SQL Server cadeia de conexão simples no SqlConnectionStringBuilder construtor do objeto e itera por 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 embutida em código em seu aplicativo.

using System.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);
        }
    }
}

Imports System.Data.SqlClient

Module Module1
    Sub Main()
        Try
            Dim connectString As String = _
                "Server=(local);Database=AdventureWorks;UID=ab;Pwd=a!Pass@@"
            Console.WriteLine("Original: " & connectString)
            Dim builder As New SqlConnectionStringBuilder(connectString)
            Console.WriteLine("Modified: " & builder.ConnectionString)
            For Each key As String In builder.Keys
                Console.WriteLine(key & "=" & builder.Item(key).ToString)
            Next
            Console.WriteLine("Press any key to finish.")
            Console.ReadLine()

        Catch ex As System.Collections.Generic.KeyNotFoundException
            Console.WriteLine("KeyNotFoundException: " & ex.Message)
        Catch ex As System.FormatException
            Console.WriteLine("Format exception: " & ex.Message)
        End Try
    End Sub
End Module

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 fornecerá 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.

Confira também

• Cadeias de conexão (ADO.NET)
• Visão geral do ADO.NET