OleDbConnectionStringBuilder Costruttori
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
- Origine:
- OleDbConnectionStringBuilder.cs
Inizializza una nuova istanza della classe OleDbConnectionStringBuilder.
public:
OleDbConnectionStringBuilder();public OleDbConnectionStringBuilder ();Public Sub New ()Vedi anche
Si applica a
OleDbConnectionStringBuilder(String)
- Origine:
- OleDbConnectionStringBuilder.cs
- 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);public OleDbConnectionStringBuilder (string connectionString);new System.Data.OleDb.OleDbConnectionStringBuilder : string -> System.Data.OleDb.OleDbConnectionStringBuilderPublic Sub New (connectionString As String)Parametri
- connectionString
- String
Base delle informazioni di connessione interne dell'oggetto. Analizzata nella coppie chiave/valore.
Eccezioni
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.
