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 ()
Aplica-se a
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 SqlConnectionStringBuilder construtor do objeto 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 SqlConnectionStringBuilder classe 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 o 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 SqlConnectionStringBuilder classe 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 ConnectionString Propriedade 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.