SqlConnection Costruttori

Definizione

Spazio dei nomi:

System.Data.SqlClient

Assembly:

System.Data.dll

Inizializza una nuova istanza della classe SqlConnection.

Overload

SqlConnection()	Inizializza una nuova istanza della classe SqlConnection.
SqlConnection(String)	Inizializza una nuova istanza della classe SqlConnection mediante una stringa che contiene la stringa di connessione.
SqlConnection(String, SqlCredential)	Inizializza una nuova istanza della classe SqlConnection data una stringa di connessione, che non usa Integrated Security = true e un oggetto SqlCredential che contiene l'ID utente e la password.

SqlConnection()

Inizializza una nuova istanza della classe SqlConnection.

public:
 SqlConnection();

public SqlConnection ();

Public Sub New ()

Esempio

Nell'esempio seguente viene creato e aperto un SqlConnectionoggetto .

private static void OpenSqlConnection()
{
    string connectionString = GetConnectionString();
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion);
        Console.WriteLine("State: {0}", connection.State);
    }
}

static private string GetConnectionString()
{
    // To avoid storing the connection string in your code,
    // you can retrieve it from a configuration file, using the
    // System.Configuration.ConfigurationManager.ConnectionStrings property
    return "Data Source=(local);Initial Catalog=AdventureWorks;"
        + "Integrated Security=SSPI;";
}

Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()
    Using connection As New SqlConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion)
        Console.WriteLine("State: {0}", connection.State)
    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, using the
    ' System.Configuration.ConfigurationManager.ConnectionStrings property
    Return "Data Source=(local);Database=AdventureWorks;" _
      & "Integrated Security=SSPI;"
End Function

Commenti

Quando viene creata una nuova istanza di SqlConnection , le proprietà di lettura/scrittura vengono impostate sui valori iniziali seguenti, a meno che non siano impostate in modo specifico usando le parole chiave associate nella ConnectionString proprietà.

Proprietà	Valore iniziale
ConnectionString	stringa vuota ("")
ConnectionTimeout	15
Database	stringa vuota ("")
DataSource	stringa vuota ("")

È possibile modificare il valore per queste proprietà solo usando la ConnectionString proprietà . La SqlConnectionStringBuilder classe fornisce funzionalità per la creazione e la gestione del contenuto delle stringhe di connessione.

Vedi anche

• Connessione a un'origine dati in ADO.NET
• SQL Server e ADO.NET
• Panoramica di ADO.NET

SqlConnection(String)

Inizializza una nuova istanza della classe SqlConnection mediante una stringa che contiene la stringa di connessione.

public:
 SqlConnection(System::String ^ connectionString);

public SqlConnection (string connectionString);

new System.Data.SqlClient.SqlConnection : string -> System.Data.SqlClient.SqlConnection

Public Sub New (connectionString As String)

Parametri

connectionString

String

Connessione usata per aprire il database di SQL Server.

Eccezioni

ArgumentException

L'argomento stringa di connessione specificato non è riuscitoConnectionString.

Esempio

Nell'esempio seguente viene creato e aperto un SqlConnectionoggetto .

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

    using (SqlConnection connection = new SqlConnection(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, using the
    // System.Configuration.ConfigurationSettings.AppSettings property
    return "Data Source=(local);Initial Catalog=AdventureWorks;"
        + "Integrated Security=SSPI;";
}

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

    Using connection As New SqlConnection(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, using the
    ' System.Configuration.ConfigurationSettings.AppSettings property
    Return "Data Source=(local);Database=AdventureWorks;" _
      & "Integrated Security=SSPI;"
End Function

Commenti

Quando viene creata una nuova istanza di SqlConnection , le proprietà di lettura/scrittura vengono impostate sui valori iniziali seguenti, a meno che non siano impostate in modo specifico usando le parole chiave associate nella ConnectionString proprietà.

Proprietà	Valore iniziale
ConnectionString	connectionString
ConnectionTimeout	15
Database	stringa vuota ("")
DataSource	stringa vuota ("")

È possibile modificare il valore per queste proprietà solo usando la ConnectionString proprietà . La SqlConnection classe fornisce funzionalità per la creazione e la gestione del contenuto delle stringhe di connessione.

Vedi anche

• Connessione a un'origine dati (ADO.NET)
• Uso del provider di dati .NET Framework per SQL Server
• Panoramica di ADO.NET

SqlConnection(String, SqlCredential)

Inizializza una nuova istanza della classe SqlConnection data una stringa di connessione, che non usa Integrated Security = true e un oggetto SqlCredential che contiene l'ID utente e la password.

public:
 SqlConnection(System::String ^ connectionString, System::Data::SqlClient::SqlCredential ^ credential);

public SqlConnection (string connectionString, System.Data.SqlClient.SqlCredential credential);

new System.Data.SqlClient.SqlConnection : string * System.Data.SqlClient.SqlCredential -> System.Data.SqlClient.SqlConnection

Public Sub New (connectionString As String, credential As SqlCredential)

Parametri

connectionString

String

Stringa di connessione che non usa le parole chiave Integrated Security = true, UserId o Password della stringa di connessione o che non usa ContextConnection = true.

credential

SqlCredential

Un oggetto SqlCredential. Se credential è Null, dal punto di vista funzionale SqlConnection(String, SqlCredential) è equivalente a SqlConnection(String).

Eccezioni

ArgumentException

L'argomento stringa di connessione specificato non è riuscitoConnectionString.

Vedi anche

• Panoramica di ADO.NET