SqlConnectionStringBuilder Costruttori

Definizione

Spazio dei nomi:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacchetto:

Microsoft.Data.SqlClient v5.2.0

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

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

Public 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

KeyNotFoundException

Nome della chiave non valido all'interno della stringa di connessione.

FormatException

Valore non valido all'interno della stringa di connessione (in maniera specifica, quando il valore booleano o numerico era previsto ma non è stato fornito).

ArgumentException

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.