SqlConnection-Konstruktor (String)

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

Namespace: System.Data.SqlClient
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Sub New ( _
    connectionString As String _
)
'Usage
Dim connectionString As String

Dim instance As New SqlConnection(connectionString)

public SqlConnection (
    string connectionString
)

public:
SqlConnection (
    String^ connectionString
)

public SqlConnection (
    String connectionString
)

public function SqlConnection (
    connectionString : String
)

Parameter

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

Hinweise

Beim Erstellen einer neuen Instanz von SqlConnection werden die Lese-/Schreibeigenschaften auf die folgenden Anfangswerte festgelegt, sofern diese nicht mit den ihnen zugeordneten Schlüsselwörtern in der ConnectionString-Eigenschaft festgelegt wurden.

Sie können den Wert dieser Eigenschaften nur mit der ConnectionString-Eigenschaft ändern. Die SqlConnection-Klasse stellt die Funktionalität zum Erstellen und Verwalten des Inhalts von Verbindungszeichenfolgen bereit.

Beispiel

Im folgenden Beispiel wird eine SqlConnection erstellt und geöffnet.

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

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SqlConnection-Klasse
SqlConnection-Member
System.Data.SqlClient-Namespace

Weitere Ressourcen

Verbinden und Abrufen von Daten mit ADO.NET
Verwenden des .NET Framework-Datenanbieters für SQL Server