OleDbConnectionStringBuilder Costruttori

Definizione

Spazio dei nomi:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacchetto:

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

Inizializza una nuova istanza della classe OleDbConnectionStringBuilder.

Overload

OleDbConnectionStringBuilder()	Inizializza una nuova istanza della classe OleDbConnectionStringBuilder.
OleDbConnectionStringBuilder(String)	Inizializza una nuova istanza della classe OleDbConnectionStringBuilder. La stringa di connessione indicata fornisce i dati per le informazioni di connessione interne dell'istanza.

OleDbConnectionStringBuilder()

Origine:

OleDbConnectionStringBuilder.cs

Inizializza una nuova istanza della classe OleDbConnectionStringBuilder.

public:
 OleDbConnectionStringBuilder();

public OleDbConnectionStringBuilder ();

Public Sub New ()

Vedi anche

• Generatori di stringhe di connessione
• Stringhe di connessione in ADO.NET

OleDbConnectionStringBuilder(String)

Origine:

OleDbConnectionStringBuilder.cs

Inizializza una nuova istanza della classe OleDbConnectionStringBuilder. La stringa di connessione indicata fornisce i dati per le informazioni di connessione interne dell'istanza.

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)

Parametri

connectionString

String

Base delle informazioni di connessione interne dell'oggetto. Analizzata nella coppie chiave/valore.

Eccezioni

ArgumentException

La stringa di connessione è formattata in modo errato (possibile mancanza del segno "=" all'interno di una coppia chiave/valore).

Esempio

Nell'esempio seguente vengono create più OleDbConnectionStringBuilder istanze, passando un stringa di connessione diverso al costruttore in ogni caso. Si noti come impostare il provider associato alla connessione modifica il set di coppie chiave/valore predefinite all'interno della raccolta dell'oggetto.

Nota

In questo esempio è inclusa una password per dimostrare il funzionamento di OleDbConnectionStringBuilder con le stringhe di connessione. Nelle applicazioni, è consigliabile utilizzare Windows Authentication. Quando è necessario utilizzare una password, non includere password hardcoded nell'applicazione.

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

Commenti

L'impostazione della proprietà, direttamente (impostando la ProviderConnectionString proprietà) o passando un stringa di connessione come parametro al costruttore, può influire sul set di coppie chiave/valore contenute nell'istanzaOleDbConnectionStringBuilder. L'impostazione della Provider proprietà su "sqloledb", ad esempio, aggiunge tutte le proprietà SQL standard stringa di connessione. Vedere l'esempio in questo argomento per una dimostrazione di questo comportamento.

Per alcuni provider, l'assegnazione di un stringa di connessione all'interno del OleDbConnectionStringBuilder costruttore causa la riorganizzazione dell'ordine di coppie chiave/valore fornite.

Vedi anche

• Generatori di stringhe di connessione
• Stringhe di connessione in ADO.NET