SqlConnection Costruttori

Definizione

Spazio dei nomi:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacchetto:

Microsoft.Data.SqlClient v5.2.0

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 oggetto SqlConnection.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

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

Commenti

Quando viene creata una nuova istanza di , le proprietà di SqlConnection lettura/scrittura vengono impostate sui valori iniziali seguenti, a meno che non vengano impostate specificamente 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.

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 Microsoft.Data.SqlClient.SqlConnection : string -> Microsoft.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 della stringa di connessione fornito non è riuscito ConnectionString .

Esempio

Nell'esempio seguente viene creato e aperto un oggetto SqlConnection.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

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

Commenti

Quando viene creata una nuova istanza di , le proprietà di SqlConnection lettura/scrittura vengono impostate sui valori iniziali seguenti, a meno che non vengano impostate specificamente 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.

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, Microsoft::Data::SqlClient::SqlCredential ^ credential);

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

new Microsoft.Data.SqlClient.SqlConnection : string * Microsoft.Data.SqlClient.SqlCredential -> Microsoft.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

Gli argomenti forniti non hanno superato la convalida, inclusa ConnectionString la convalida.