OleDbConnectionStringBuilder Constructeurs

Définition

Initialise une nouvelle instance de la classe OleDbConnectionStringBuilder.

Surcharges

OleDbConnectionStringBuilder()

Initialise une nouvelle instance de la classe OleDbConnectionStringBuilder.

OleDbConnectionStringBuilder(String)

Initialise une nouvelle instance de la classe OleDbConnectionStringBuilder. La chaîne de connexion spécifiée fournit les données pour les informations de connexion internes de l'instance.

OleDbConnectionStringBuilder()

Initialise une nouvelle instance de la classe OleDbConnectionStringBuilder.

public:
 OleDbConnectionStringBuilder();
public OleDbConnectionStringBuilder ();
Public Sub New ()

Voir aussi

S’applique à

OleDbConnectionStringBuilder(String)

Initialise une nouvelle instance de la classe OleDbConnectionStringBuilder. La chaîne de connexion spécifiée fournit les données pour les informations de connexion internes de l'instance.

public:
 OleDbConnectionStringBuilder(System::String ^ connectionString);
public OleDbConnectionStringBuilder (string connectionString);
public OleDbConnectionStringBuilder (string? connectionString);
new System.Data.OleDb.OleDbConnectionStringBuilder : string -> System.Data.OleDb.OleDbConnectionStringBuilder
Public Sub New (connectionString As String)

Paramètres

connectionString
String

Base pour les informations de connexion internes de l'objet. Analysée dans les paires clé/valeur.

Exceptions

La chaîne de connexion est incorrectement mise en forme (le signe "=" requis peut ne pas figurer dans une paire clé/valeur).

Exemples

L’exemple suivant crée plusieurs OleDbConnectionStringBuilder instances, en passant une chaîne de connexion différente au constructeur dans chaque cas. Notez que 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 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

Remarques

La définition Provider de la propriété, soit directement (en définissant la ConnectionString propriété), soit en passant une chaîne de connexion en tant que paramètre au constructeur, peut affecter l’ensemble de paires clé/valeur contenues dans l' OleDbConnectionStringBuilder instance. Providerpar exemple, si vous affectez à la propriété la valeur « sqloledb », toutes les propriétés de chaîne de connexion SQL standard sont ajoutées. Pour une démonstration de ce comportement, consultez l’exemple de cette rubrique.

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

Voir aussi

S’applique à