SqlConnection Constructors
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Initialiseert een nieuw exemplaar van de SqlConnection klasse.
Overloads
| Name | Description |
|---|---|
| SqlConnection() |
Initialiseert een nieuw exemplaar van de SqlConnection klasse. |
| SqlConnection(String) |
Initialiseert een nieuw exemplaar van de klasse SqlConnection bij een tekenreeks die de verbindingsreeks bevat. |
| SqlConnection(String, SqlCredential) |
Initialiseert een nieuw exemplaar van de klasse SqlConnection op basis van een verbindingsreeks, die geen gebruik maakt van |
SqlConnection()
Initialiseert een nieuw exemplaar van de SqlConnection klasse.
public:
SqlConnection();
public SqlConnection();
Public Sub New ()
Voorbeelden
In het volgende voorbeeld wordt een SqlConnection.
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
Opmerkingen
Wanneer er een nieuw exemplaar van wordt gemaakt, worden de eigenschappen voor lezen/schrijven ingesteld op de volgende initiële waarden, tenzij ze specifiek zijn ingesteld met behulp van SqlConnection de bijbehorende trefwoorden in de ConnectionString eigenschap.
| Properties | Initiële waarde |
|---|---|
| ConnectionString | lege tekenreeks ("") |
| ConnectionTimeout | 15 |
| Database | lege tekenreeks ("") |
| DataSource | lege tekenreeks ("") |
U kunt de waarde voor deze eigenschappen alleen wijzigen met behulp van de ConnectionString eigenschap. De SqlConnectionStringBuilder klasse biedt functionaliteit voor het maken en beheren van de inhoud van verbindingsreeksen.
Zie ook
Van toepassing op
SqlConnection(String)
Initialiseert een nieuw exemplaar van de klasse SqlConnection bij een tekenreeks die de verbindingsreeks bevat.
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)
Parameters
- connectionString
- String
De verbinding die wordt gebruikt om de SQL Server-database te openen.
Uitzonderingen
Het opgegeven argument verbindingsreeks is mislukt ConnectionString validatie.
Voorbeelden
In het volgende voorbeeld wordt een SqlConnection.
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
Opmerkingen
Wanneer er een nieuw exemplaar van wordt gemaakt, worden de eigenschappen voor lezen/schrijven ingesteld op de volgende initiële waarden, tenzij ze specifiek zijn ingesteld met behulp van SqlConnection de bijbehorende trefwoorden in de ConnectionString eigenschap.
| Properties | Initiële waarde |
|---|---|
| ConnectionString | connectionString |
| ConnectionTimeout | 15 |
| Database | lege tekenreeks ("") |
| DataSource | lege tekenreeks ("") |
U kunt de waarde voor deze eigenschappen alleen wijzigen met behulp van de ConnectionString eigenschap. De SqlConnection klasse biedt functionaliteit voor het maken en beheren van de inhoud van verbindingsreeksen.
Zie ook
- Connecting to a Data Source (ADO.NET)
- Using the .NET Framework Data Provider for SQL Server
- overzicht van ADO.NET
Van toepassing op
SqlConnection(String, SqlCredential)
Initialiseert een nieuw exemplaar van de klasse SqlConnection op basis van een verbindingsreeks, die geen gebruik maakt van Integrated Security = true en een SqlCredential-object dat de gebruikers-id en het wachtwoord bevat.
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)
Parameters
- connectionString
- String
Een verbindingsreeks die geen van de volgende verbindingsreeks trefwoorden gebruikt: Integrated Security = true, UserId of Password; of die geen gebruik maakt van ContextConnection = true.
- credential
- SqlCredential
Een SqlCredential-object. Als credential null is, SqlConnection(String, SqlCredential) is dit functioneel gelijk aan SqlConnection(String).
Uitzonderingen
Het opgegeven argument verbindingsreeks is mislukt ConnectionString validatie.