共用方式為

SqlConnection 建構函式

定義

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

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

多載

名稱 Description
SqlConnection()

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

當給定包含連接字串的字串時，初始化該類別的新 SqlConnection 實例。
SqlConnection(String, SqlCredential)

初始化一個新實例， SqlConnection 給定一個不使用 Integrated Security = true 包含使用者 ID 和密碼的連接字串和 SqlCredential 物件。

SqlConnection()

來源:
System.Data.SqlClient.notsupported.cs

初始化 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)

來源:
System.Data.SqlClient.notsupported.cs

當給定包含連接字串的字串時，初始化該類別的新 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)

來源:
System.Data.SqlClient.notsupported.cs

初始化一個新實例， SqlConnection 給定一個不使用 Integrated Security = true 包含使用者 ID 和密碼的連接字串和 SqlCredential 物件。

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 為空， SqlConnection(String, SqlCredential) 則在功能上等價於 SqlConnection(String)。

例外狀況

ArgumentException

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

另請參閱

適用於