SqlCommand 建構函式

定義

命名空間:

System.Data.SqlClient

組件:

System.Data.dll

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

多載

SqlCommand()	初始化 SqlCommand 類別的新執行個體。
SqlCommand(String)	使用查詢的文字，初始化 SqlCommand 類別的新執行個體。
SqlCommand(String, SqlConnection)	使用查詢的文字和 SqlConnection 初始化 SqlCommand 類別的新執行個體。
SqlCommand(String, SqlConnection, SqlTransaction)	使用查詢的文字、SqlConnection 和 SqlTransaction，初始化 SqlCommand 類別的新執行個體。
SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)	使用指定的命令文字、連接、交易和加密設定，初始化 SqlCommand 類別的新執行個體。

SqlCommand()

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

public:
 SqlCommand();

public SqlCommand ();

Public Sub New ()

範例

下列範例會 SqlCommand 建立 並設定 CommandTimeout 屬性。

public void CreateSqlCommand()
{
   SqlCommand command = new SqlCommand();
   command.CommandTimeout = 15;
   command.CommandType = CommandType.Text;
}

Public Sub CreateSqlCommand()
    Dim command As New SqlCommand()
    command.CommandTimeout = 15
    command.CommandType = CommandType.Text
End Sub

備註

基底建構函式會將所有字段初始化為其預設值。 下表顯示 實例 SqlCommand的初始屬性值。

屬性	初始值
CommandText	空字串 (“”)
CommandTimeout	30
CommandType	CommandType.Text
Connection	Null

您可以透過對 屬性的個別呼叫來變更這些屬性的值。

另請參閱

• 在 ADO.NET 中傳送和修改資料
• SQL Server and ADO.NET (SQL Server 和 ADO.NET)
• ADO.NET 概觀 \(部分機器翻譯\)

SqlCommand(String)

使用查詢的文字，初始化 SqlCommand 類別的新執行個體。

public:
 SqlCommand(System::String ^ cmdText);

public SqlCommand (string cmdText);

new System.Data.SqlClient.SqlCommand : string -> System.Data.SqlClient.SqlCommand

Public Sub New (cmdText As String)

參數

cmdText

String

查詢的文字。

範例

下列範例會SqlCommand建立 ，傳入 連接字串 和命令文字。

public void CreateCommand()
 {
    string queryString = "SELECT * FROM Categories ORDER BY CategoryID";
    SqlCommand command = new SqlCommand(queryString);
    command.CommandTimeout = 15;
    command.CommandType = CommandType.Text;
 }

Public Sub CreateCommand()
    Dim queryString As String = "SELECT * FROM Categories ORDER BY CategoryID"
    Dim command As New SqlCommand(queryString)
    command.CommandTimeout = 15
    command.CommandType = CommandType.Text
End Sub

備註

建立 的 SqlCommand 實例時，下列讀取/寫入屬性會設定為初始值。

屬性	初始值
CommandText	cmdText
CommandTimeout	30
CommandType	CommandType.Text
Connection	null

您可以透過對 屬性的個別呼叫來變更這些屬性的值。

另請參閱

• 連接和擷取 ADO.NET 中的數據
• 使用 .NET Framework Data Provider for SQL Server
• ADO.NET 概觀 \(部分機器翻譯\)

SqlCommand(String, SqlConnection)

使用查詢的文字和 SqlConnection 初始化 SqlCommand 類別的新執行個體。

public:
 SqlCommand(System::String ^ cmdText, System::Data::SqlClient::SqlConnection ^ connection);

public SqlCommand (string cmdText, System.Data.SqlClient.SqlConnection connection);

new System.Data.SqlClient.SqlCommand : string * System.Data.SqlClient.SqlConnection -> System.Data.SqlClient.SqlCommand

Public Sub New (cmdText As String, connection As SqlConnection)

參數

cmdText

String

查詢的文字。

connection

SqlConnection

SqlConnection，代表 SQL Server 執行個體的連接。

範例

下列範例會建立 ， SqlCommand 並設定其部分屬性。

private static void CreateCommand(string queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(
            queryString, connection);
        connection.Open();
        SqlDataReader reader = command.ExecuteReader();
        while (reader.Read())
        {
            Console.WriteLine(String.Format("{0}, {1}",
                reader[0], reader[1]));
        }
    }
}

Public Sub CreateCommand(ByVal queryString As String, _
  ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)

        connection.Open()
        Dim reader As SqlDataReader = command.ExecuteReader()
            While reader.Read()
            Console.WriteLine(String.Format("{0}, {1}", _
                reader(0), reader(1)))
        End While
    End Using
End Sub

備註

下表顯示 實例 SqlCommand的初始屬性值。

屬性	初始值
CommandText	cmdText
CommandTimeout	30
CommandType	CommandType.Text
Connection	新的 SqlConnection ，這是參數的值 connection 。

您可以藉由設定相關屬性來變更這些參數的值。

另請參閱

• 連接和擷取 ADO.NET 中的數據
• 使用 .NET Framework Data Provider for SQL Server
• ADO.NET 概觀 \(部分機器翻譯\)

SqlCommand(String, SqlConnection, SqlTransaction)

使用查詢的文字、SqlConnection 和 SqlTransaction，初始化 SqlCommand 類別的新執行個體。

public:
 SqlCommand(System::String ^ cmdText, System::Data::SqlClient::SqlConnection ^ connection, System::Data::SqlClient::SqlTransaction ^ transaction);

public SqlCommand (string cmdText, System.Data.SqlClient.SqlConnection connection, System.Data.SqlClient.SqlTransaction transaction);

new System.Data.SqlClient.SqlCommand : string * System.Data.SqlClient.SqlConnection * System.Data.SqlClient.SqlTransaction -> System.Data.SqlClient.SqlCommand

Public Sub New (cmdText As String, connection As SqlConnection, transaction As SqlTransaction)

參數

cmdText

String

查詢的文字。

connection

SqlConnection

SqlConnection，代表 SQL Server 執行個體的連接。

transaction

SqlTransaction

SqlCommand 執行的所在 SqlTransaction。

備註

下表顯示 實例 SqlCommand的初始屬性值。

屬性	初始值
CommandText	cmdText
CommandTimeout	30
CommandType	CommandType.Text
Connection	新的 SqlConnection ，這是參數的值 connection 。

您可以藉由設定相關屬性來變更這些參數的值。

另請參閱

• 連接和擷取 ADO.NET 中的數據
• 使用 .NET Framework Data Provider for SQL Server
• ADO.NET 概觀 \(部分機器翻譯\)

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

使用指定的命令文字、連接、交易和加密設定，初始化 SqlCommand 類別的新執行個體。

public:
 SqlCommand(System::String ^ cmdText, System::Data::SqlClient::SqlConnection ^ connection, System::Data::SqlClient::SqlTransaction ^ transaction, System::Data::SqlClient::SqlCommandColumnEncryptionSetting columnEncryptionSetting);

public SqlCommand (string cmdText, System.Data.SqlClient.SqlConnection connection, System.Data.SqlClient.SqlTransaction transaction, System.Data.SqlClient.SqlCommandColumnEncryptionSetting columnEncryptionSetting);

new System.Data.SqlClient.SqlCommand : string * System.Data.SqlClient.SqlConnection * System.Data.SqlClient.SqlTransaction * System.Data.SqlClient.SqlCommandColumnEncryptionSetting -> System.Data.SqlClient.SqlCommand

Public Sub New (cmdText As String, connection As SqlConnection, transaction As SqlTransaction, columnEncryptionSetting As SqlCommandColumnEncryptionSetting)

參數

cmdText

String

查詢的文字。

connection

SqlConnection

SqlConnection，代表 SQL Server 執行個體的連接。

transaction

SqlTransaction

SqlCommand 執行的所在 SqlTransaction。

columnEncryptionSetting

SqlCommandColumnEncryptionSetting

加密設定。 如需詳細資訊，請參閱 Always Encrypted。