SqlConnection Konstruktoren

Referenz

Definition

Namespace:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Assemblys:: netstandard.dll, System.Data.SqlClient.dll

Paket:: System.Data.SqlClient v4.8.6

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 instance 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

Gilt für:

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

Die angegebene Verbindungszeichenfolge Argument konnte nicht ConnectionString überprüft werden.

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

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

Gilt für:

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

Die angegebene Verbindungszeichenfolge Argument konnte nicht ConnectionString überprüft werden.

Weitere Informationen

Übersicht über ADO.NET

Gilt für:

Freigeben über

SqlConnection Konstruktoren

Definition

Überlädt

SqlConnection()

Beispiele

Hinweise

Weitere Informationen

Gilt für:

SqlConnection(String)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

SqlConnection(String, SqlCredential)

Parameter

Ausnahmen

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen