OdbcConnectionStringBuilder Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicializa uma nova instância da classe OdbcConnectionStringBuilder.
Sobrecargas
| OdbcConnectionStringBuilder() |
Inicializa uma nova instância da classe OdbcConnectionStringBuilder. |
| OdbcConnectionStringBuilder(String) |
Inicializa uma nova instância da classe OdbcConnectionStringBuilder. A cadeia de conexão fornecida oferece os dados para obter informações de conexão internas da instância. |
OdbcConnectionStringBuilder()
Inicializa uma nova instância da classe OdbcConnectionStringBuilder.
public:
OdbcConnectionStringBuilder();public OdbcConnectionStringBuilder ();Public Sub New ()Confira também
Aplica-se a
OdbcConnectionStringBuilder(String)
Inicializa uma nova instância da classe OdbcConnectionStringBuilder. A cadeia de conexão fornecida oferece os dados para obter informações de conexão internas da instância.
public:
OdbcConnectionStringBuilder(System::String ^ connectionString);public OdbcConnectionStringBuilder (string? connectionString);public OdbcConnectionStringBuilder (string connectionString);new System.Data.Odbc.OdbcConnectionStringBuilder : string -> System.Data.Odbc.OdbcConnectionStringBuilderPublic Sub New (connectionString As String)Parâmetros
- connectionString
- String
A base das informações de conexão internas do objeto. Analisado em pares chave/valor.
Exceções
A cadeia de conexão está formatada incorretamente (talvez sem o "=" necessário em um par chave/valor).
Exemplos
O exemplo a seguir cria várias OdbcConnectionStringBuilder instâncias, passando uma cadeia de conexão diferente para o construtor em cada caso. Observe que a ordenação de elementos no cadeia de conexão pode ser modificada quando você recupera a ConnectionString propriedade. Observe também que chaves diferentes das chaves "Dsn" e "Driver" predefinidas são convertidas em letras minúsculas pela OdbcConnectionStringBuilder classe .
Observação
Este exemplo inclui uma senha para demonstrar como OdbcConnectionStringBuilder 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 System.Data.Odbc;
class Program
{
static void Main()
{
try
{
// Build an empty instance, just to see
// the contents of the keys.
DumpBuilderContents("");
// Create a SQL Server connection string.
DumpBuilderContents("Driver={SQL Server};Server=(local);Database=AdventureWorks;Uid=ab;Pwd=pass@word1");
// Create an Access connection string.
DumpBuilderContents(@"Driver={Microsoft Access Driver (*.mdb)};Dbq=C:\info.mdb;Exclusive=1;Uid=admin;Pwd=pass@word1");
// Create an Oracle connection string.
DumpBuilderContents("Driver={Microsoft ODBC for Oracle};Server=OracleServer.world;Uid=Admin;Pwd=pass@word1;");
// Create a Sybase connection string.
DumpBuilderContents("Driver={SYBASE ASE ODBC Driver};Srvr=SomeServer;Uid=admin;Pwd=pass@word1");
Console.WriteLine("Press any key to finish.");
Console.ReadLine();
}
catch (System.ArgumentException ex)
{
Console.WriteLine("Error: " + ex.Message);
}
}
private static void DumpBuilderContents(string connectString)
{
OdbcConnectionStringBuilder builder =
new OdbcConnectionStringBuilder(connectString);
Console.WriteLine("=================");
Console.WriteLine("Original connectString = " + connectString);
Console.WriteLine("builder.ConnectionString = " + builder.ConnectionString);
foreach (string key in builder.Keys)
{
Console.WriteLine(key + "=" + builder[key].ToString());
}
}
}
Imports System.Data.Odbc
Module Module1
Sub Main()
Try
' Build an empty instance, just to see
' the contents of the keys.
DumpBuilderContents("")
' Create a SQL Server connection string.
DumpBuilderContents("Driver={SQL Server};Server=(local);Database=AdventureWorks;Uid=ab;Pwd=pass@word1")
' Create an Access connection string.
DumpBuilderContents("Driver={Microsoft Access Driver (*.mdb)};Dbq=C:\info.mdb;Exclusive=1;Uid=admin;Pwd=pass@word1")
' Create an Oracle connection string.
DumpBuilderContents("Driver={Microsoft ODBC for Oracle};Server=OracleServer.world;Uid=Admin;Pwd=pass@word1;")
' Create a Sybase connection string.
DumpBuilderContents("Driver={SYBASE ASE ODBC Driver};Srvr=SomeServer;Uid=admin;Pwd=pass@word1")
Console.WriteLine("Press any key to finish.")
Console.ReadLine()
Catch ex As System.ArgumentException
Console.WriteLine("Error: " & ex.Message)
End Try
End Sub
Private Sub DumpBuilderContents(ByVal connectString As String)
Dim builder As New OdbcConnectionStringBuilder(connectString)
Console.WriteLine("=================")
Console.WriteLine("Original connectString = " & connectString)
Console.WriteLine("builder.ConnectionString = " & builder.ConnectionString)
For Each key As String In builder.Keys
Console.WriteLine(key & "=" & builder.Item(key).ToString)
Next
End Sub
End Module
Comentários
Você pode passar um cadeia de conexão no construtor ou definir a ConnectionString propriedade explicitamente. O comportamento é o mesmo de qualquer maneira.
