SqlConnection Costruttori
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 |
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.
Si applica a
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
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.
Si applica a
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
Gli argomenti forniti non hanno superato la convalida, inclusa ConnectionString la convalida.