SqlConnection Oluşturucular

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Aşırı Yüklemeler

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()

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.

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

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.

SqlConnection(String)

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 Microsoft.Data.SqlClient.SqlConnection : string -> Microsoft.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.

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

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.

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.

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)

Parametreler

connectionString

String

Şu bağlantı dizesi anahtar sözcüklerinden hiçbirini kullanmayan bir bağlantı dizesi: Integrated Security = true, UserIdveya Passwordveya kullanmayan 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ğımsız değişkenler doğrulama da dahil olmak üzere ConnectionString doğrulanamadı.