SqlConnectionStringBuilder Costruttori

Definizione

Spazio dei nomi:

System.Data.SqlClient

Assembly:

System.Data.dll

Inizializza una nuova istanza della classe SqlConnectionStringBuilder.

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

Vedi anche

• Panoramica di ADO.NET

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 System.Data.SqlClient.SqlConnectionStringBuilder : string -> System.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 System.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);
        }
    }
}

Imports System.Data.SqlClient

Module Module1
    Sub Main()
        Try
            Dim connectString As String = _
                "Server=(local);Database=AdventureWorks;UID=ab;Pwd=a!Pass@@"
            Console.WriteLine("Original: " & connectString)
            Dim builder As New SqlConnectionStringBuilder(connectString)
            Console.WriteLine("Modified: " & builder.ConnectionString)
            For Each key As String In builder.Keys
                Console.WriteLine(key & "=" & builder.Item(key).ToString)
            Next
            Console.WriteLine("Press any key to finish.")
            Console.ReadLine()

        Catch ex As System.Collections.Generic.KeyNotFoundException
            Console.WriteLine("KeyNotFoundException: " & ex.Message)
        Catch ex As System.FormatException
            Console.WriteLine("Format exception: " & ex.Message)
        End Try
    End Sub
End Module

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 ConnectionString proprietà dell'oggetto viene recuperata, la stringa contiene solo coppie chiave/valore in cui il valore non è il valore predefinito per l'elemento.

Vedi anche

• Stringhe di connessione (ADO.NET)
• Panoramica di ADO.NET