SqlConnection Oluşturucular

  • Başvuru

Tanım

Ad Alanı:
System.Data.SqlClient
Bütünleştirilmiş Kod:
System.Data.SqlClient.dll
Bütünleştirilmiş Kod:
System.Data.dll
Bütünleştirilmiş Kodlar:
netstandard.dll, System.Data.SqlClient.dll
Paket:
System.Data.SqlClient v4.8.6

SqlConnection sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

SqlConnection()

SqlConnection sınıfının yeni bir örneğini başlatır.
SqlConnection(String)

bağlantı dizesi içeren bir dize verildiğinde sınıfının yeni bir örneğini SqlConnection başlatır.
SqlConnection(String, SqlCredential)

kullanıcı kimliği ve parolayı SqlConnection içeren bir nesne kullanmayan Integrated Security = true bir bağlantı dizesi verilen sınıfının yeni bir SqlCredential örneğini başlatır.

SqlConnection()

SqlConnection sınıfının yeni bir örneğini başlatır.

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

Örnekler

Aşağıdaki örnek bir SqlConnectionoluşturur ve açar.

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

Açıklamalar

Yeni bir örneği SqlConnection oluşturulduğunda, özellikle özelliğindeki ilişkili anahtar sözcükleri kullanılarak ayarlanmadıkları sürece okuma/yazma özellikleri aşağıdaki başlangıç değerlerine ConnectionString ayarlanır.

Özellikler İlk değer
ConnectionString boş dize ("")
ConnectionTimeout 15
Database boş dize ("")
DataSource boş dize ("")

Bu özelliklerin değerini yalnızca özelliğini kullanarak ConnectionString değiştirebilirsiniz. sınıfı, SqlConnectionStringBuilder bağlantı dizelerinin içeriğini oluşturmak ve yönetmek için işlevsellik sağlar.

Ayrıca bkz.

Şunlara uygulanır

SqlConnection(String)

bağlantı dizesi içeren bir dize verildiğinde sınıfının yeni bir örneğini SqlConnection başlatır.

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)

Parametreler

connectionString
String

SQL Server veritabanını açmak için kullanılan bağlantı.

Özel durumlar

ArgumentException

Sağlanan bağlantı dizesi bağımsız değişkeni doğrulanamadıConnectionString.

Örnekler

Aşağıdaki örnek bir SqlConnectionoluşturur ve açar.

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

Açıklamalar

Yeni bir örneği SqlConnection oluşturulduğunda, özellikle özelliğindeki ilişkili anahtar sözcükleri kullanılarak ayarlanmadıkları sürece okuma/yazma özellikleri aşağıdaki başlangıç değerlerine ConnectionString ayarlanır.

Özellikler İlk değer
ConnectionString connectionString
ConnectionTimeout 15
Database boş dize ("")
DataSource boş dize ("")

Bu özelliklerin değerini yalnızca özelliğini kullanarak ConnectionString değiştirebilirsiniz. sınıfı, SqlConnection bağlantı dizelerinin içeriğini oluşturmak ve yönetmek için işlevsellik sağlar.

Ayrıca bkz.

Şunlara uygulanır

SqlConnection(String, SqlCredential)

kullanıcı kimliği ve parolayı SqlConnection içeren bir nesne kullanmayan Integrated Security = true bir bağlantı dizesi verilen sınıfının yeni bir SqlCredential örneğini başlatır.

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)

Parametreler

connectionString
String

Aşağıdaki bağlantı dizesi anahtar sözcüklerinden hiçbirini kullanmayan bir bağlantı dizesi: Integrated Security = true, UserIdveya Passwordveya kullanmazContextConnection = true.

credential
SqlCredential

Bir SqlCredential nesnesi. null ise credential , SqlConnection(String, SqlCredential) işlevsel olarak ile SqlConnection(String)eşdeğerdir.

Özel durumlar

ArgumentException

Sağlanan bağlantı dizesi bağımsız değişkeni doğrulanamadıConnectionString.

Ayrıca bkz.

Şunlara uygulanır