SqlConnection.ConnectionString Proprietà

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

public:
 property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

public override string ConnectionString { get; set; }

[System.Data.DataSysDescription("SqlConnection_ConnectionString")]
public string ConnectionString { get; set; }

[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }

member this.ConnectionString : string with get, set

[<System.Data.DataSysDescription("SqlConnection_ConnectionString")>]
member this.ConnectionString : string with get, set

[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set

Public Overrides Property ConnectionString As String

Public Property ConnectionString As String

Valore della proprietà

Stringa di connessione che include il nome del database di origine e altri parametri necessari per stabilire la connessione iniziale. Il valore predefinito è una stringa vuota.

Implementazioni

Attributi

DataSysDescriptionAttribute SettingsBindableAttribute

Eccezioni

Esempio

Nell'esempio seguente viene creato un SqlConnection oggetto e viene impostata la ConnectionString proprietà prima di aprire la connessione.

private static void OpenSqlConnection()
{
    string connectionString = GetConnectionString();

    using (SqlConnection connection = new SqlConnection())
    {
        connection.ConnectionString = connectionString;

        connection.Open();

        Console.WriteLine("State: {0}", connection.State);
        Console.WriteLine("ConnectionString: {0}",
            connection.ConnectionString);
    }
}

static private string GetConnectionString()
{
    // To avoid storing the connection string in your code,
    // you can retrieve it from a configuration file.
    return "Data Source=MSSQL1;Initial Catalog=AdventureWorks;"
        + "Integrated Security=true;";
}

Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()

    Using connection As New SqlConnection()

        connection.ConnectionString = connectionString

        connection.Open()

        Console.WriteLine("State: {0}", connection.State)
        Console.WriteLine("ConnectionString: {0}", _
            connection.ConnectionString)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,  
    ' you can retrieve it from a configuration file.
    Return "Data Source=MSSQL1;Database=AdventureWorks;" _
      & "Integrated Security=true;"
End Function

Commenti

ConnectionString è simile a una stringa di connessione OLE DB, ma non è identica. A differenza di OLE DB o ADO, la stringa di connessione restituita è uguale a quella impostata ConnectionStringdall'utente , meno le informazioni di sicurezza se il valore Persist Security Info è impostato su false (impostazione predefinita). Il provider di dati .NET Framework per SQL Server non persiste o restituisce la password in una stringa di connessione, a meno che non si imposti Persist Security Info su true.

È possibile utilizzare la ConnectionString proprietà per connettersi a un database. Nell'esempio seguente viene illustrata una stringa di connessione tipica.

"Persist Security Info=False;Integrated Security=true;Initial Catalog=Northwind;server=(local)"

Usare il nuovo SqlConnectionStringBuilder per costruire stringhe di connessione valide in fase di esecuzione. Per altre informazioni, vedere Compilatori di stringhe di connessione.

La ConnectionString proprietà può essere impostata solo quando la connessione viene chiusa. Molti dei valori della stringa di connessione hanno proprietà di sola lettura corrispondenti. Quando la stringa di connessione è impostata, queste proprietà vengono aggiornate, tranne quando viene rilevato un errore. In questo caso, nessuna delle proprietà viene aggiornata. SqlConnection le proprietà restituiscono solo le impostazioni contenute in ConnectionString.

Per connettersi a un computer locale, specificare "(local)" per il server. Se non viene specificato un nome server, verrà tentata una connessione all'istanza predefinita nel computer locale.

La reimpostazione di ConnectionString in una connessione chiusa reimposta tutti i valori della stringa di connessione (e le proprietà correlate), inclusa la password. Ad esempio, se si imposta una stringa di connessione che include "Database= AdventureWorks" e quindi si reimposta la stringa di connessione su "Data Source=myserver; Integrated Security=true, la Database proprietà non è più impostata su "AdventureWorks".

La stringa di connessione viene analizzata immediatamente dopo l'impostazione. Se durante l'analisi vengono rilevati errori nella sintassi, viene generata un'eccezione di runtime, ad esempio ArgumentException, . È possibile trovare altri errori solo quando viene effettuato un tentativo di aprire la connessione.

Il formato di base di una stringa di connessione include una serie di coppie di parole chiave/valore separate da punti e virgola. Il segno di uguale (=) connette ogni parola chiave e il relativo valore. Per includere valori contenenti un punto e virgola, un carattere virgolette singole o virgolette doppie, il valore deve essere racchiuso tra virgolette doppie. Se il valore contiene sia un punto e virgola che un carattere virgolette doppie, il valore può essere racchiuso tra virgolette singole. La virgoletta singola è utile anche se il valore inizia con un carattere virgolette doppie. Viceversa, la virgoletta doppia può essere usata se il valore inizia con una virgoletta singola. Se il valore contiene virgolette singole e virgolette doppie, la virgoletta usata per racchiudere il valore deve essere raddoppiata ogni volta che si verifica all'interno del valore.

Per includere spazi precedenti o finali nel valore stringa, il valore deve essere racchiuso tra virgolette singole o virgolette doppie. Tutti gli spazi iniziali o finali intorno a valori interi, booleani o enumerati vengono ignorati, anche se racchiusi tra virgolette. Tuttavia, gli spazi all'interno di una parola chiave o valore letterale stringa vengono mantenuti. Le virgolette singole o doppie possono essere utilizzate all'interno di una stringa di connessione senza utilizzare delimitatori (ad esempio, Origine dati= my'Server o Origine dati= my"Server), a meno che una virgoletta non sia il primo o l'ultimo carattere nel valore.

Le parole chiave non fanno distinzione tra maiuscole e minuscole.

Nella tabella seguente sono elencati i nomi validi per i valori delle parole chiave all'interno di ConnectionString.

L'elenco seguente contiene i nomi validi per i valori del pool di connessioni all'interno di ConnectionString. Per altre informazioni, vedere Pool di connessioni SQL Server (ADO.NET).

• Connection Lifetime (o Load Balance Timeout)
• Enlist
• Max Pool Size
• Min Pool Size
• Pooling

Quando si impostano valori di pool di trueparole chiave o di connessione che richiedono un valore booleano, è possibile usare yes anziché e no anziché false. I valori integer sono rappresentati come stringhe.

Vedi anche

• provider gestiti ADO.NET e centro per sviluppatori dataset
• Stringhe di connessione in ADO.NET
• Pool di Connessione di SQL Server (ADO.NET)
• Connessione a un'origine dati in ADO.NET
• Panoramica di ADO.NET