SqlConnection Konstruktor

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Overload

SqlConnection()	Menginisialisasi instans baru kelas SqlConnection.
SqlConnection(String)	Menginisialisasi instans SqlConnection baru kelas saat diberikan string yang berisi string koneksi.
SqlConnection(String, SqlCredential)	Menginisialisasi instans baru kelas SqlConnection yang diberikan string koneksi, yang tidak menggunakan Integrated Security = true dan SqlCredential objek yang berisi ID pengguna dan kata sandi.

SqlConnection()

Menginisialisasi instans baru kelas SqlConnection.

public:
 SqlConnection();

public SqlConnection ();

Public Sub New ()

Contoh

Contoh berikut membuat dan membuka SqlConnection.

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

Keterangan

Saat instans SqlConnection baru dibuat, properti baca/tulis diatur ke nilai awal berikut kecuali secara khusus diatur menggunakan kata kunci terkait di ConnectionString properti .

Properti	Nilai awal
ConnectionString	string kosong ("")
ConnectionTimeout	15
Database	string kosong ("")
DataSource	string kosong ("")

Anda dapat mengubah nilai untuk properti ini hanya dengan menggunakan ConnectionString properti . Kelas ini SqlConnectionStringBuilder menyediakan fungsionalitas untuk membuat dan mengelola konten string koneksi.

SqlConnection(String)

Menginisialisasi instans SqlConnection baru kelas saat diberikan string yang berisi string koneksi.

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

Koneksi yang digunakan untuk membuka database SQL Server.

Pengecualian

ArgumentException

Argumen string koneksi yang disediakan gagal ConnectionString validasi.

Contoh

Contoh berikut membuat dan membuka SqlConnection.

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

Keterangan

Saat instans SqlConnection baru dibuat, properti baca/tulis diatur ke nilai awal berikut kecuali secara khusus diatur menggunakan kata kunci terkait di ConnectionString properti .

Properti	Nilai awal
ConnectionString	connectionString
ConnectionTimeout	15
Database	string kosong ("")
DataSource	string kosong ("")

Anda dapat mengubah nilai untuk properti ini hanya dengan menggunakan ConnectionString properti . Kelas ini SqlConnection menyediakan fungsionalitas untuk membuat dan mengelola konten string koneksi.

SqlConnection(String, SqlCredential)

Menginisialisasi instans baru kelas SqlConnection yang diberikan string koneksi, yang tidak menggunakan Integrated Security = true dan SqlCredential objek yang berisi ID pengguna dan kata sandi.

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

String koneksi yang tidak menggunakan salah satu kata kunci string koneksi berikut: Integrated Security = true, , UserIdatau Password; atau yang tidak menggunakan ContextConnection = true.

credential

SqlCredential

Objek SqlCredential. Jika credential null, SqlConnection(String, SqlCredential) secara fungsional SqlConnection(String)setara dengan .

Pengecualian

ArgumentException

Argumen yang disediakan gagal validasi, termasuk ConnectionString validasi.