OleDbConnectionStringBuilder Constructeurs

Définition

Espace de noms:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Paquet:

System.Data.OleDb v9.0.0-preview.3.24172.9

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

Source:

OleDbConnectionStringBuilder.cs

Initialise une nouvelle instance de la classe OleDbConnectionStringBuilder.

public:
 OleDbConnectionStringBuilder();

public OleDbConnectionStringBuilder ();

Public Sub New ()

Voir aussi

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

OleDbConnectionStringBuilder(String)

Source:

OleDbConnectionStringBuilder.cs

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

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

ArgumentException

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