Freigeben über


SqlConnection Konstruktoren

Definition

Ü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.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

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

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.

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 Microsoft.Data.SqlClient.SqlConnection : string -> Microsoft.Data.SqlClient.SqlConnection
Public Sub New (connectionString As String)

Parameter

connectionString
String

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

Ausnahmen

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

Beispiele

Im folgenden Beispiel wird eine SqlConnectionerstellt und geöffnet.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

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

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.

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, Microsoft::Data::SqlClient::SqlCredential ^ credential);
public SqlConnection (string connectionString, Microsoft.Data.SqlClient.SqlCredential credential);
new Microsoft.Data.SqlClient.SqlConnection : string * Microsoft.Data.SqlClient.SqlCredential -> Microsoft.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

Fehler bei der Validierung der angegebenen Argumente, einschließlich ConnectionString validierung.

Gilt für: