SqlConnection 建構函式

  • 參考

定義

命名空間:
System.Data.SqlClient
組件:
System.Data.SqlClient.dll
組件:
System.Data.dll
套件:
System.Data.SqlClient v4.8.6

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

多載

SqlConnection()

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

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

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

SqlConnection()

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

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

範例

下列範例會建立並開啟 SqlConnection。

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

備註

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

屬性 初始值
ConnectionString 空字串 (“”)
ConnectionTimeout 15
Database 空字串 (“”)
DataSource 空字串 (“”)

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

另請參閱

適用於

SqlConnection(String)

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

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)

參數

connectionString
String

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

例外狀況

ArgumentException

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

範例

下列範例會建立並開啟 SqlConnection。

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

備註

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

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

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

另請參閱

適用於

SqlConnection(String, SqlCredential)

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

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)

參數

connectionString
String

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

credential
SqlCredential

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

例外狀況

ArgumentException

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

另請參閱

適用於