SqlConnectionStringBuilder Construtores

Definição

Inicializa uma nova instância da classe SqlConnectionStringBuilder.Initializes a new instance of the SqlConnectionStringBuilder class.

Sobrecargas

SqlConnectionStringBuilder()

Inicializa uma nova instância da classe SqlConnectionStringBuilder.Initializes a new instance of the SqlConnectionStringBuilder class.

SqlConnectionStringBuilder(String)

Inicializa uma nova instância da classe SqlConnectionStringBuilder.Initializes a new instance of the SqlConnectionStringBuilder class. A cadeia de conexão fornecida oferece os dados para obter informações de conexão internas da instância.The provided connection string provides the data for the instance's internal connection information.

SqlConnectionStringBuilder()

Inicializa uma nova instância da classe SqlConnectionStringBuilder.Initializes a new instance of the SqlConnectionStringBuilder class.

public:
 SqlConnectionStringBuilder();
public SqlConnectionStringBuilder ();
Public Sub New ()

Veja também

SqlConnectionStringBuilder(String)

Inicializa uma nova instância da classe SqlConnectionStringBuilder.Initializes a new instance of the SqlConnectionStringBuilder class. A cadeia de conexão fornecida oferece os dados para obter informações de conexão internas da instância.The provided connection string provides the data for the instance's internal connection information.

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.The basis for the object's internal connection information. Analisado em pares nome/valor.Parsed into name/value pairs. Nomes de chave inválidos geram KeyNotFoundException.Invalid key names raise KeyNotFoundException.

Exceções

Nome de chave inválido na cadeia de conexão.Invalid key name within the connection string.

Valor inválido na cadeia de conexão (especificamente, quando um valor numérico ou booliano era esperado, mas não foi fornecido).Invalid value within the connection string (specifically, when a Boolean or numeric value was expected but not supplied).

A connectionString fornecida não é válida.The supplied connectionString is not valid.

Exemplos

O exemplo a seguir fornece uma cadeia de conexão simples SQL Server no construtor do objeto SqlConnectionStringBuilder e, em seguida, faz a iteração por meio de todos os pares de chave/valor dentro do objeto.The following example supplies a simple SQL Server connection string in the SqlConnectionStringBuilder object's constructor, and then iterates through all the key/value pairs within the object. Observe que a coleção fornece valores padrão para cada item.Note that the collection provides default values for each item. Observe também que a classe SqlConnectionStringBuilder converte sinônimos para as chaves conhecidas, para que elas sejam consistentes com os nomes bem conhecidos.Also note that the SqlConnectionStringBuilder class converts synonyms for the well-known keys so that they are consistent with the well-known names.

Observação

Este exemplo inclui uma senha para demonstrar como SqlConnectionStringBuilder funciona com cadeias de conexão.This example includes a password to demonstrate how SqlConnectionStringBuilder works with connection strings. Em seus aplicativos, recomendamos que você use a autenticação do Windows.In your applications, we recommend that you use Windows Authentication. Se você precisar usar uma senha, não inclua uma senha embutida em código em seu aplicativo.If you must use a password, do not include a hard-coded password in your application.

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 classe SqlConnectionStringBuilder fornece uma coleção interna fixa de pares de chave/valor.The SqlConnectionStringBuilder class provides a fixed internal collection of key/value pairs. 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 de chave/valor.Even if you supply only a small subset of the possible connection string values in the constructor, the object always provides default values for each key/value pair. Quando a propriedade ConnectionString do objeto é recuperada, a cadeia de caracteres contém somente pares de chave/valor em que o valor não é o valor padrão para o item.When the ConnectionString property of the object is retrieved, the string contains only key/value pairs in which the value is not the default value for the item.

Veja também

Aplica-se a