SqlConnection Konstruktoren

Definition

Initialisiert eine neue Instanz der SqlConnection-Klasse.Initializes a new instance of the SqlConnection class.

Überlädt

SqlConnection()

Initialisiert eine neue Instanz der SqlConnection-Klasse.Initializes a new instance of the SqlConnection class.

SqlConnection(String)

Initialisiert eine neue Instanz der SqlConnection-Klasse, sofern eine Zeichenfolge mit der Verbindungszeichenfolge angegeben wird.Initializes a new instance of the SqlConnection class when given a string that contains the connection string.

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.Initializes a new instance of the SqlConnection class given a connection string, that does not use Integrated Security = true and a SqlCredential object that contains the user ID and password.

SqlConnection()

Initialisiert eine neue Instanz der SqlConnection-Klasse.Initializes a new instance of the SqlConnection class.

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

Beispiele

Im folgenden Beispiel wird ein erstellt und geöffnet SqlConnection .The following example creates and opens a 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 von SqlConnection erstellt wird, werden die Lese-/Schreibeigenschaften auf die folgenden Anfangswerte festgelegt, es sei denn, Sie werden speziell mithilfe der zugehörigen Schlüsselwörter in der-Eigenschaft festgelegt ConnectionString .When a new instance of SqlConnection is created, the read/write properties are set to the following initial values unless they are specifically set using their associated keywords in the ConnectionString property.

EigenschaftenProperties AnfangswertInitial value
ConnectionString leere Zeichenfolge ("")empty string ("")
ConnectionTimeout 1515
Database leere Zeichenfolge ("")empty string ("")
DataSource leere Zeichenfolge ("")empty string ("")

Sie können den Wert für diese Eigenschaften nur ändern, indem Sie die- ConnectionString Eigenschaft verwenden.You can change the value for these properties only by using the ConnectionString property. Die- SqlConnectionStringBuilder Klasse stellt Funktionen zum Erstellen und Verwalten der Inhalte von Verbindungs Zeichenfolgen bereit.The SqlConnectionStringBuilder class provides functionality for creating and managing the contents of connection strings.

Gilt für:

SqlConnection(String)

Initialisiert eine neue Instanz der SqlConnection-Klasse, sofern eine Zeichenfolge mit der Verbindungszeichenfolge angegeben wird.Initializes a new instance of the SqlConnection class when given a string that contains the connection string.

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.The connection used to open the SQL Server database.

Beispiele

Im folgenden Beispiel wird ein erstellt und geöffnet SqlConnection .The following example creates and opens a 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 von SqlConnection erstellt wird, werden die Lese-/Schreibeigenschaften auf die folgenden Anfangswerte festgelegt, es sei denn, Sie werden speziell mithilfe der zugehörigen Schlüsselwörter in der-Eigenschaft festgelegt ConnectionString .When a new instance of SqlConnection is created, the read/write properties are set to the following initial values unless they are specifically set using their associated keywords in the ConnectionString property.

EigenschaftenProperties AnfangswertInitial value
ConnectionString connectionString
ConnectionTimeout 1515
Database leere Zeichenfolge ("")empty string ("")
DataSource leere Zeichenfolge ("")empty string ("")

Sie können den Wert für diese Eigenschaften nur ändern, indem Sie die- ConnectionString Eigenschaft verwenden.You can change the value for these properties only by using the ConnectionString property. Die- SqlConnection Klasse stellt Funktionen zum Erstellen und Verwalten der Inhalte von Verbindungs Zeichenfolgen bereit.The SqlConnection class provides functionality for creating and managing the contents of connection strings.

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.Initializes a new instance of the SqlConnection class given a connection string, that does not use Integrated Security = true and a SqlCredential object that contains the user ID and password.

public:
 SqlConnection(System::String ^ connectionString, System::Data::SqlClient::SqlCredential ^ credential);
public:
 SqlConnection(System::String ^ connectionString, System::Data::SqlClient::SqlCredential ^ cred);
public SqlConnection (string connectionString, System.Data.SqlClient.SqlCredential credential);
public SqlConnection (string connectionString, System.Data.SqlClient.SqlCredential cred);
new System.Data.SqlClient.SqlConnection : string * System.Data.SqlClient.SqlCredential -> System.Data.SqlClient.SqlConnection
new System.Data.SqlClient.SqlConnection : string * System.Data.SqlClient.SqlCredential -> System.Data.SqlClient.SqlConnection
Public Sub New (connectionString As String, credential As SqlCredential)
Public Sub New (connectionString As String, cred 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.A connection string that does not use any of the following connection string keywords: Integrated Security = true, UserId, or Password; or that does not use ContextConnection = true.

credentialcred
SqlCredential

Ein SqlCredential-Objekt.A SqlCredential object. Wenn credential 0 (null) ist, dann ist SqlConnection(String, SqlCredential) zu SqlConnection(String) funktional äquivalent.If credential is null, SqlConnection(String, SqlCredential) is functionally equivalent to SqlConnection(String).

Gilt für: