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 contiene il nome del database di origine e altri parametri necessari a 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

L'oggetto ConnectionString è simile a un stringa di connessione OLE DB, ma non è identico. 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 Persistent Security Info è impostato su false (impostazione predefinita). Il provider di dati .NET Framework per SQL Server non persiste o restituisce la password in un stringa di connessione a meno che non si impostaNo informazioni di sicurezza persistenti su true.

È possibile usare la ConnectionString proprietà per connettersi a un database. Nell'esempio seguente viene illustrato un stringa di connessione tipico.

"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 stringa di connessione hanno proprietà di sola lettura corrispondenti. Quando viene impostata la stringa di connessione, queste proprietà vengono aggiornate, tranne quando viene rilevato un errore. In questo caso, nessuno delle proprietà viene aggiornato. SqlConnection le proprietà restituiscono solo le impostazioni contenute in ConnectionString.

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

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

Il stringa di connessione viene analizzato immediatamente dopo essere stato impostato. Se vengono trovati errori nella sintassi durante l'analisi, viene generata un'eccezione di runtime, ad esempio ArgumentException, . È possibile trovare altri errori solo quando viene eseguito un tentativo di apertura della connessione.

Il formato di base di un stringa di connessione include una serie di coppie chiave/valore separate da punti e virgola. Il segno di uguale (=) connette ogni parola chiave al relativo valore. Per includere valori contenenti un punto e virgola, un carattere di virgolette singole o un carattere di virgolette doppie, il valore deve essere racchiuso tra virgolette doppie. Se il valore contiene sia un punto e virgola che un carattere di virgolette doppie, il valore può essere racchiuso tra virgolette singole. La virgolette singola è utile anche se il valore inizia con un carattere di virgolette doppie. Al contrario, la virgoletta doppia può essere usata se il valore inizia con una virgoletta singola. Se il valore contiene sia virgolette singole che virgolette doppie, il carattere di virgolette utilizzato per racchiudere il valore deve essere raddoppiato 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 integer, booleani o enumerati vengono ignorati, anche se racchiusi tra virgolette. Tuttavia, gli spazi all'interno di una parola chiave letterale stringa o valore vengono mantenuti. Le virgolette singole o doppie possono essere usate all'interno di un stringa di connessione senza usare delimitatori (ad esempio, Origine dati= my'Server o Origine dati= my"Server), a meno che un carattere di virgolette non sia il primo o l'ultimo carattere nel valore.

Le parole chiave non sono 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).

• Durata della connessione (o timeout del bilanciamento del carico)

• Inserisci

• Dimensione max pool

• Dimensione min pool

• Pooling

Quando si impostano valori di pool di parole chiave o connessioni che richiedono un valore booleano, è possibile usare "sì" anziché "true" e "no" anziché "false". I valori integer sono rappresentati come stringhe.

Si applica a

Vedi anche

• Provider gestiti ADO.NET e Centro per sviluppatori di set di dati
• Stringhe di connessione in ADO.NET
• Pool di connessioni SQL Server (ADO.NET)
• Connessione a un'origine dati in ADO.NET
• Panoramica di ADO.NET