OleDbConnectionStringBuilder Constructores
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inicializa una nueva instancia de la clase OleDbConnectionStringBuilder.
Sobrecargas
| OleDbConnectionStringBuilder() |
Inicializa una nueva instancia de la clase OleDbConnectionStringBuilder. |
| OleDbConnectionStringBuilder(String) |
Inicializa una nueva instancia de la clase OleDbConnectionStringBuilder. La cadena de conexión proporcionada facilita los datos para la información de conexión interna de la instancia. |
OleDbConnectionStringBuilder()
Inicializa una nueva instancia de la clase OleDbConnectionStringBuilder.
public:
OleDbConnectionStringBuilder();public OleDbConnectionStringBuilder ();Public Sub New ()Consulte también
Se aplica a
OleDbConnectionStringBuilder(String)
Inicializa una nueva instancia de la clase OleDbConnectionStringBuilder. La cadena de conexión proporcionada facilita los datos para la información de conexión interna de la instancia.
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
Base para la información de conexión interna del objeto. Se analiza en pares de clave/valor.
Excepciones
El formato de la cadena de conexión no es correcto (quizás falte el signo "=" necesario en un par de clave/valor).
Ejemplos
En el ejemplo siguiente se crean varias OleDbConnectionStringBuilder instancias, pasando un cadena de conexión diferente al constructor en cada caso. Observe cómo establecer el proveedor asociado a la conexión cambia el conjunto de pares clave-valor predefinidos dentro de la colección del objeto.
Nota
Este ejempo incluye una contraseña para demostrar cómo OleDbConnectionStringBuilder funciona con cadenas de conexión. Se recomienda que utilice autenticación de Windows en sus aplicaciones. Si necesita utilizar una contraseña en su aplicación, no incluya una contraseña codificada de forma rígida.
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
Comentarios
Establecer la Provider propiedad, ya sea directamente (estableciendo la ConnectionString propiedad) o pasando un cadena de conexión como parámetro al constructor, puede afectar al conjunto de pares clave-valor contenidos en la OleDbConnectionStringBuilder instancia. Al establecer la Provider propiedad en "sqloledb", por ejemplo, se agregan todas las propiedades estándar de SQL cadena de conexión. Consulte el ejemplo de este tema para ver una demostración de este comportamiento.
Para algunos proveedores, asignar un cadena de conexión dentro del OleDbConnectionStringBuilder constructor hace que el orden de los pares clave-valor proporcionados se reorganice.
