Freigeben über

SqlConnection Konstruktoren

Definition

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll

Initialisiert eine neue Instanz der SqlConnection-Klasse.

Überlädt

Name Beschreibung
SqlConnection()

Initialisiert eine neue Instanz der SqlConnection-Klasse.
SqlConnection(String)

Initialisiert eine neue Instanz der SqlConnection Klasse, wenn eine Zeichenfolge angegeben wird, die die Verbindungszeichenfolge enthält.
SqlConnection(String, SqlCredential)

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

SqlConnection()

Quelle:
System.Data.SqlClient.notsupported.cs

Initialisiert eine neue Instanz der SqlConnection-Klasse.

public:
 SqlConnection();
public SqlConnection();
Public Sub New ()

Beispiele

Im folgenden Beispiel wird ein 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

Hinweise

Wenn eine neue Instanz erstellt SqlConnection wird, werden die Lese-/Schreibeigenschaften auf die folgenden Anfangswerte festgelegt, es sei denn, sie werden speziell mit ihren zugeordneten Schlüsselwörtern 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)

Quelle:
System.Data.SqlClient.notsupported.cs

Initialisiert eine neue Instanz der SqlConnection Klasse, wenn eine Zeichenfolge angegeben wird, die die Verbindungszeichenfolge enthält.

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, die zum Öffnen der SQL Server-Datenbank verwendet wird.

Ausnahmen

ArgumentException

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

Beispiele

Im folgenden Beispiel wird ein 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

Hinweise

Wenn eine neue Instanz erstellt SqlConnection wird, werden die Lese-/Schreibeigenschaften auf die folgenden Anfangswerte festgelegt, es sei denn, sie werden speziell mit ihren zugeordneten Schlüsselwörtern 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

Gilt für:

SqlConnection(String, SqlCredential)

Quelle:
System.Data.SqlClient.notsupported.cs

Initialisiert eine neue Instanz der SqlConnection Klasse mit einer Verbindungszeichenfolge, die nicht verwendet Integrated Security = true wird, und ein SqlCredential Objekt, 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 Verbindungszeichenfolgenstichwörter verwendet: Integrated Security = true, , UserIdoder Password; oder die nicht verwendet ContextConnection = truewird.

credential
SqlCredential

Ein SqlCredential-Objekt. Wenn credential null ist, SqlConnection(String, SqlCredential) entspricht sie SqlConnection(String)funktionell dem .

Ausnahmen

ArgumentException

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

Weitere Informationen

Gilt für: