Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Costruttore SqlConnectionStringBuilder (String)

 

Data di pubblicazione: ottobre 2016

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

Spazio dei nomi:   System.Data.SqlClient
Assembly:  System.Data (in System.Data.dll)

public SqlConnectionStringBuilder(
	string connectionString
)

Parametri

connectionString
Type: System.String

Base delle informazioni di connessione interne dell'oggetto. Analizzata in coppie nome/valore. I nomi della chiave non validi generano l'eccezione KeyNotFoundException.

Exception Condition
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.

The T:System.Data.SqlClient.SqlConnectionStringBuilder class provides a fixed internal collection of key/value pairs. Even if you supply only a small subset of the possible connection string values in the constructor, the object always provides default values for each key/value pair. When the ConnectionString property of the object is retrieved, the string contains only key/value pairs in which the value is not the default value for the item.

The following example supplies a simple SQL Server connection string in the T:System.Data.SqlClient.SqlConnectionStringBuilder object's constructor, and then iterates through all the key/value pairs within the object. Note that the collection provides default values for each item. Also note that the T:System.Data.SqlClient.SqlConnectionStringBuilder class converts synonyms for the well-known keys so that they are consistent with the well-known names.

System_CAPS_noteNota

This example includes a password to demonstrate how T:System.Data.SqlClient.SqlConnectionStringBuilder works with connection strings. In your applications, we recommend that you use Windows Authentication. If you must use a password, do not include a hard-coded password in your application.

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);
        }
    }
}

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: