SqlConnectionStringBuilder 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.
Overload
| SqlConnectionStringBuilder() |
Inizializza una nuova istanza della classe SqlConnectionStringBuilder. |
| SqlConnectionStringBuilder(String) |
Inizializza una nuova istanza della classe SqlConnectionStringBuilder. La stringa di connessione indicata fornisce i dati per le informazioni di connessione interne dell'istanza. |
SqlConnectionStringBuilder()
Inizializza una nuova istanza della classe SqlConnectionStringBuilder.
public:
SqlConnectionStringBuilder();public SqlConnectionStringBuilder ();Public Sub New ()Si applica a
SqlConnectionStringBuilder(String)
Inizializza una nuova istanza della classe SqlConnectionStringBuilder. La stringa di connessione indicata fornisce i dati per le informazioni di connessione interne dell'istanza.
public:
SqlConnectionStringBuilder(System::String ^ connectionString);public SqlConnectionStringBuilder (string connectionString);new Microsoft.Data.SqlClient.SqlConnectionStringBuilder : string -> Microsoft.Data.SqlClient.SqlConnectionStringBuilderPublic Sub New (connectionString As String)Parametri
- connectionString
- String
Base delle informazioni di connessione interne dell'oggetto. Analizzata in coppie nome/valore. I nomi della chiave non validi generano l'eccezione KeyNotFoundException.
Eccezioni
Nome della chiave non valido all'interno della stringa di connessione.
Valore non valido all'interno della stringa di connessione (in maniera specifica, quando il valore booleano o numerico era previsto ma non è stato fornito).
L'elemento connectionString fornito non è valido.
Esempio
Nell'esempio seguente viene fornita una stringa di connessione SQL Server semplice nel costruttore dell'oggetto SqlConnectionStringBuilder che viene iterata tramite le coppie chiave/valore all'interno dell'oggetto. Notare che la raccolta fornisce valori predefiniti per ogni elemento. Notare inoltre che la classe SqlConnectionStringBuilder converte i sinonimi per le chiavi note in modo che siano coerenti con i nomi noti.
Nota
In questo esempio è inclusa una password per dimostrare il funzionamento di SqlConnectionStringBuilder con le stringhe di connessione. Nelle applicazioni, è consigliabile utilizzare Windows Authentication. Quando è necessario utilizzare una password, non includere password hardcoded nell'applicazione.
using Microsoft.Data.SqlClient;
class Program
{
static void Main()
{
try
{
string connectString =
"Server=(local);Database=AdventureWorks;UID=ab;Pwd= a!Pass@@";
Console.WriteLine("Original: " + connectString);
SqlConnectionStringBuilder builder =
new SqlConnectionStringBuilder(connectString);
Console.WriteLine("Modified: " + builder.ConnectionString);
foreach (string key in builder.Keys)
Console.WriteLine(key + "=" + builder[key].ToString());
Console.WriteLine("Press any key to finish.");
Console.ReadLine();
}
catch (System.Collections.Generic.KeyNotFoundException ex)
{
Console.WriteLine("KeyNotFoundException: " + ex.Message);
}
catch (System.FormatException ex)
{
Console.WriteLine("Format exception: " + ex.Message);
}
}
}
Commenti
La classe SqlConnectionStringBuilder fornisce una raccolta interna fissa di coppie chiave/valore. Anche se viene fornito solo un piccolo subset di possibili valori della stringa di connessione nel costruttore, l'oggetto fornisce sempre valori predefiniti per ogni coppia chiave/valore. Quando la proprietà dell'oggetto viene recuperata, la ConnectionString stringa contiene solo coppie chiave/valore in cui il valore non è il valore predefinito per l'elemento.