SqlConnection Konstruktoren

Definition

Namespace:

System.Data.SqlClient

Assembly:

System.Data.SqlClient.dll

Paket:

System.Data.SqlClient v4.8.6

Initialisiert eine neue Instanz der SqlConnection-Klasse.

Überlädt

SqlConnection()	Initialisiert eine neue Instanz der SqlConnection-Klasse.
SqlConnection(String)	Initialisiert eine neue Instanz der SqlConnection-Klasse, sofern eine Zeichenfolge mit der Verbindungszeichenfolge angegeben wird.
SqlConnection(String, SqlCredential)	Initialisiert eine neue Instanz der SqlConnection-Klasse mit einer Verbindungszeichenfolge, die weder Integrated Security = true noch ein SqlCredential-Objekt verwendet, das die Benutzer-ID und das Kennwort enthält.

SqlConnection()

Initialisiert eine neue Instanz der SqlConnection-Klasse.

public:
 SqlConnection();

public SqlConnection ();

Public Sub New ()

Beispiele

Im folgenden Beispiel wird eine SqlConnectionerstellt und geöffnet.

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

Hinweise

Wenn eine neue Instanz von SqlConnection erstellt wird, werden die Lese-/Schreibeigenschaften auf die folgenden Anfangswerte festgelegt, es sei denn, sie werden speziell mithilfe der zugeordneten Schlüsselwörter in der ConnectionString -Eigenschaft festgelegt.

Eigenschaften	Anfangswert
ConnectionString	leere Zeichenfolge ("")
ConnectionTimeout	15
Database	leere Zeichenfolge ("")
DataSource	leere Zeichenfolge ("")

Sie können den Wert für diese Eigenschaften nur mithilfe der ConnectionString -Eigenschaft ändern. Die SqlConnectionStringBuilder -Klasse bietet Funktionen zum Erstellen und Verwalten des Inhalts von Verbindungszeichenfolgen.

Weitere Informationen

• Herstellen einer Verbindung mit einer Datenquelle in ADO.NET
• SQL Server und ADO.NET
• Übersicht über ADO.NET

SqlConnection(String)

Initialisiert eine neue Instanz der SqlConnection-Klasse, sofern eine Zeichenfolge mit der Verbindungszeichenfolge angegeben wird.

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)

Parameter

connectionString

String

Die Verbindung, mit der die SQL Server-Datenbank geöffnet wird.

Ausnahmen

ArgumentException

Fehler bei der ConnectionString Überprüfung des angegebenen Verbindungszeichenfolgenarguments.

Beispiele

Im folgenden Beispiel wird eine SqlConnectionerstellt und geöffnet.

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

Hinweise

Wenn eine neue Instanz von SqlConnection erstellt wird, werden die Lese-/Schreibeigenschaften auf die folgenden Anfangswerte festgelegt, es sei denn, sie werden speziell mithilfe der zugeordneten Schlüsselwörter in der ConnectionString -Eigenschaft festgelegt.

Eigenschaften	Anfangswert
ConnectionString	connectionString
ConnectionTimeout	15
Database	leere Zeichenfolge ("")
DataSource	leere Zeichenfolge ("")

Sie können den Wert für diese Eigenschaften nur mithilfe der ConnectionString -Eigenschaft ändern. Die SqlConnection -Klasse bietet Funktionen zum Erstellen und Verwalten des Inhalts von Verbindungszeichenfolgen.

Weitere Informationen

• Verbinden mit einer Datenquelle (ADO.NET)
• Verwenden des .NET Framework-Datenanbieters für SQL Server
• Übersicht über ADO.NET

SqlConnection(String, SqlCredential)

Initialisiert eine neue Instanz der SqlConnection-Klasse mit einer Verbindungszeichenfolge, die weder Integrated Security = true noch ein SqlCredential-Objekt verwendet, das die Benutzer-ID und das Kennwort enthält.

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)

Parameter

connectionString

String

Eine Verbindungszeichenfolge, die keine der folgenden Schlüsselwörter für Verbindungszeichenfolgen verwendet: Integrated Security = true, UserId oder Password; oder die ContextConnection = true nicht verwendet.

credential

SqlCredential

Ein SqlCredential-Objekt. Wenn credential 0 (null) ist, dann ist SqlConnection(String, SqlCredential) zu SqlConnection(String) funktional äquivalent.

Ausnahmen

ArgumentException

Fehler bei der ConnectionString Überprüfung des angegebenen Verbindungszeichenfolgenarguments.

Weitere Informationen

• Übersicht über ADO.NET