OleDbConnectionStringBuilder 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 OleDbConnectionStringBuilder.
Sobrecargas
| OleDbConnectionStringBuilder() |
Inicializa uma nova instância da classe OleDbConnectionStringBuilder. |
| OleDbConnectionStringBuilder(String) |
Inicializa uma nova instância da classe OleDbConnectionStringBuilder. A cadeia de conexão fornecida oferece os dados para obter informações de conexão internas da instância. |
OleDbConnectionStringBuilder()
Inicializa uma nova instância da classe OleDbConnectionStringBuilder.
public:
OleDbConnectionStringBuilder();public OleDbConnectionStringBuilder ();Public Sub New ()Confira também
Aplica-se a
OleDbConnectionStringBuilder(String)
Inicializa uma nova instância da classe OleDbConnectionStringBuilder. A cadeia de conexão fornecida oferece os dados para obter informações de conexão internas da instância.
public:
OleDbConnectionStringBuilder(System::String ^ connectionString);public OleDbConnectionStringBuilder (string? connectionString);public OleDbConnectionStringBuilder (string connectionString);new System.Data.OleDb.OleDbConnectionStringBuilder : string -> System.Data.OleDb.OleDbConnectionStringBuilderPublic 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 OleDbConnectionStringBuilder instâncias, passando uma cadeia de conexão diferente para o construtor em cada caso. Observe como definir o provedor associado à conexão altera o conjunto de pares chave/valor predefinidos dentro da coleção do objeto.
Observação
Este exemplo inclui uma senha para demonstrar como OleDbConnectionStringBuilder 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.OleDb;
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("Provider=sqloledb;Data Source=(local);" +
"Initial Catalog=AdventureWorks;" +
"User Id=ab;Password=Password@1");
// Create an Access connection string.
DumpBuilderContents("Provider=Microsoft.Jet.OLEDB.4.0;" +
@"Data Source=C:\Sample.mdb");
// Create an Oracle connection string.
DumpBuilderContents("Provider=msdaora;Data Source=SomeOracleDb;" +
"User Id=userName;Password=Pass@word1;");
// Create an Sybase connection string.
DumpBuilderContents("Provider=ASAProv;Data source=myASA");
Console.WriteLine("Press any key to finish.");
Console.ReadLine();
}
catch (System.ArgumentException ex)
{
Console.WriteLine("Error: " + ex.Message);
}
}
private static void DumpBuilderContents(string connectString)
{
OleDbConnectionStringBuilder builder =
new OleDbConnectionStringBuilder(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.OleDb
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("Provider=sqloledb;Data Source=(local);" & _
"Initial Catalog=AdventureWorks;" & _
"User Id=ab;Password=Password@1")
' Create an Access connection string.
DumpBuilderContents("Provider=Microsoft.Jet.OLEDB.4.0;" & _
"Data Source=C:\Sample.mdb")
' Create an Oracle connection string.
DumpBuilderContents("Provider=msdaora;Data Source=SomeOracleDb;" & _
"User Id=userName;Password=Pass@word1;")
' Create a Sybase connection string.
DumpBuilderContents("Provider=ASAProv;Data source=myASA")
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 OleDbConnectionStringBuilder(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
Definir a Provider propriedade, diretamente (definindo a ConnectionString propriedade) ou passando um cadeia de conexão como um parâmetro para o construtor, pode afetar o conjunto de pares chave/valor contidos na OleDbConnectionStringBuilder instância. Definir a Provider propriedade como "sqloledb", por exemplo, adiciona todas as propriedades padrão do SQL cadeia de conexão. Consulte o exemplo neste tópico para obter uma demonstração desse comportamento.
Para alguns provedores, atribuir um cadeia de conexão dentro do OleDbConnectionStringBuilder construtor faz com que a ordem dos pares chave/valor fornecidos seja reorganizada.
