OleDbConnectionStringBuilder.Provider Propiedad

Referencia

Definición

Espacio de nombres:: System.Data.OleDb

Ensamblado:: System.Data.OleDb.dll

Ensamblado:: System.Data.dll

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í.

Obtiene o establece una cadena que contiene el nombre del proveedor de datos asociado a la cadena de conexión interna.

public:
 property System::String ^ Provider { System::String ^ get(); void set(System::String ^ value); };

public string Provider { get; set; }

[System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbConnectionStringBuilder+OleDbProviderConverter))]
public string Provider { get; set; }

member this.Provider : string with get, set

[<System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbConnectionStringBuilder+OleDbProviderConverter))>]
member this.Provider : string with get, set

Public Property Provider As String

Valor de propiedad

String

Valor de la propiedad Provider o String.Empty si no se ha proporcionado ninguno.

Atributos: TypeConverterAttribute

Ejemplos

En el ejemplo siguiente se crean varias OleDbConnectionStringBuilder instancias, pasando una cadena de conexión diferente al constructor en cada caso. Tenga en cuenta 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 a 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

Si el valor enviado es nulo cuando intente establecer la propiedad, la propiedad Provider es restablecida. Si no se ha establecido el valor y el desarrollador intenta recuperar la propiedad , el valor devuelto es String.Empty. Esta propiedad corresponde a la clave "Provider" dentro de la cadena de conexión.

Establecer el valor de la Provider propiedad, ya sea directamente (estableciendo la ConnectionString propiedad) o pasando una 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 SQL cadena de conexión. Consulte el ejemplo de este tema para obtener una demostración de este comportamiento.

Para algunos proveedores, asignar una cadena de conexión dentro del OleDbConnectionStringBuilder constructor hace que se reorganice el orden de los pares clave-valor proporcionados.

Se aplica a