OleDbConnectionStringBuilder Constructores

Definición

Espacio de nombres:

System.Data.OleDb

Ensamblado:

System.Data.OleDb.dll

Paquete:

System.Data.OleDb v9.0.0-rc.2.24473.5

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

• Generadores de cadenas de conexión
• Cadenas de conexión de ADO.NET

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);

new System.Data.OleDb.OleDbConnectionStringBuilder : string -> System.Data.OleDb.OleDbConnectionStringBuilder

Public 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

ArgumentException

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.

Consulte también

• Generadores de cadenas de conexión
• Cadenas de conexión de ADO.NET