OleDbConnectionStringBuilder.Provider Propriété

Définition

Espace de noms:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Paquet:

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

Source:

OleDbConnectionStringBuilder.cs

Obtient ou définit une chaîne qui contient le nom du fournisseur de données associé à la chaîne de connexion interne.

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

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

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

Public Property Provider As String

Valeur de propriété

String

Valeur de la propriété Provider, ou String.Empty si aucune valeur n’a été fournie.

Attributs

TypeConverterAttribute

Exemples

L’exemple suivant crée plusieurs OleDbConnectionStringBuilder instances, en passant une chaîne de connexion différente au constructeur dans chaque cas. Notez comment la définition du fournisseur associé à la connexion modifie l’ensemble de paires clé/valeur prédéfinies dans la collection de l’objet.

Notes

Cet exemple inclut un mot de passe pour illustrer l'utilisation de OleDbConnectionStringBuilder avec les chaînes de connexion. Dans vos applications, nous vous recommandons d'utiliser l'authentification Windows. Si vous devez utiliser un mot de passe, n'incluez pas de mot de passe codé en dur dans votre application.

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

Remarques

Si la valeur passée est Null lors de la tentative de définition de la propriété, la propriété Provider est réinitialisée. Si la valeur n’a pas été définie et que le développeur tente de récupérer la propriété, la valeur de retour est String.Empty. Cette propriété correspond à la clé « Provider » dans le chaîne de connexion.

La définition de la valeur de la Provider propriété, soit directement (en définissant la ConnectionString propriété) soit en passant un chaîne de connexion en tant que paramètre au constructeur, peut affecter l’ensemble de paires clé/valeur contenues dans le OleDbConnectionStringBuilder instance. La définition de la Provider propriété sur « sqloledb », par exemple, ajoute toutes les propriétés sql chaîne de connexion standard. Consultez l’exemple de cette rubrique pour une démonstration de ce comportement.

Pour certains fournisseurs, l’affectation d’un chaîne de connexion au sein du OleDbConnectionStringBuilder constructeur entraîne la réorganisation de l’ordre des paires clé/valeur fournies.

Voir aussi

• Builders de chaînes de connexion
• Chaînes de connexion dans ADO.NET