SqlConnection 建構函式

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v5.2.0

多載

SqlConnection()	初始化 SqlConnection 類別的新執行個體。
SqlConnection(String)	指定包含連接字串的字串時，初始化 SqlConnection 類別的新執行個體。
SqlConnection(String, SqlCredential)	指定不使用 Integrated Security = true 和包含使用者 ID 和密碼之 SqlCredential 物件的連接字串，初始化 SqlConnection 類別的新執行個體。

SqlConnection()

初始化 SqlConnection 類別的新執行個體。

public:
 SqlConnection();

public SqlConnection ();

Public Sub New ()

範例

下列範例會建立並開啟 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;";
    }
}

備註

建立 的新實例 SqlConnection 時，讀取/寫入屬性會設定為下列初始值，除非在 屬性中使用 ConnectionString 其相關聯的關鍵字進行特別設定。

屬性	初始值
ConnectionString	空字串 (「」)
ConnectionTimeout	15
Database	空字串 (「」)
DataSource	空字串 (「」)

您只能使用 ConnectionString 屬性來變更這些屬性的值。 類別 SqlConnectionStringBuilder 提供建立和管理連接字串內容的功能。

SqlConnection(String)

指定包含連接字串的字串時，初始化 SqlConnection 類別的新執行個體。

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)

參數

connectionString

String

開啟 SQL Server 資料庫所使用的連線。

例外狀況

ArgumentException

提供的連接字串引數驗證失敗 ConnectionString 。

範例

下列範例會建立並開啟 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;";
    }
}

備註

建立 的新實例 SqlConnection 時，讀取/寫入屬性會設定為下列初始值，除非在 屬性中使用 ConnectionString 其相關聯的關鍵字進行特別設定。

屬性	初始值
ConnectionString	connectionString
ConnectionTimeout	15
Database	空字串 (「」)
DataSource	空字串 (「」)

您只能使用 ConnectionString 屬性來變更這些屬性的值。 類別 SqlConnection 提供建立和管理連接字串內容的功能。

SqlConnection(String, SqlCredential)

指定不使用 Integrated Security = true 和包含使用者 ID 和密碼之 SqlCredential 物件的連接字串，初始化 SqlConnection 類別的新執行個體。

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)

參數

connectionString

String

不使用下列任何連接字串關鍵字的連接字串：Integrated Security = true、UserId 或 Password；或者不使用 ContextConnection = true 的連接字串。

credential

SqlCredential

SqlCredential 物件。 如果 credential 為 Null，SqlConnection(String, SqlCredential) 在功能上相當於 SqlConnection(String)。

例外狀況

ArgumentException

提供的引數驗證失敗，包括 ConnectionString 驗證。