Aracılığıyla paylaş

SqlConnection Oluşturucular

Tanım

Ad Alanı:
System.Data.SqlClient
Bütünleştirilmiş Kod:
System.Data.SqlClient.dll
Bütünleştirilmiş Kod:
System.Data.dll

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

Aşırı Yüklemeler

Name Description
SqlConnection()

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

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

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

SqlConnection()

Kaynak:
System.Data.SqlClient.notsupported.cs

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, okuma/yazma özellikleri özellikle özelliğindeki ilişkili anahtar sözcükleri kullanılarak ayarlanmadığı sürece 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)

Kaynak:
System.Data.SqlClient.notsupported.cs

Bağlantı dizesini SqlConnection içeren bir dize verildiğinde sınıfının yeni bir örneğini 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, okuma/yazma özellikleri özellikle özelliğindeki ilişkili anahtar sözcükleri kullanılarak ayarlanmadığı sürece 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)

Kaynak:
System.Data.SqlClient.notsupported.cs

Kullanmayan SqlConnection bir bağlantı dizesi Integrated Security = true ve kullanıcı kimliği ile parolayı içeren bir nesne verilen sınıfı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

Şu bağlantı dizesi anahtar sözcüklerinden herhangi birini kullanmayan bir bağlantı dizesi: Integrated Security = true, UserIdveya Passwordveya veya kullanmaz ContextConnection = 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