SqlCommand 建構函式

參考

定義

命名空間:: Microsoft.Data.SqlClient

組件:: Microsoft.Data.SqlClient.dll

套件:: Microsoft.Data.SqlClient v1.0.19269.1

套件:: Microsoft.Data.SqlClient v1.1.4

套件:: Microsoft.Data.SqlClient v2.0.1

套件:: Microsoft.Data.SqlClient v2.1.4

套件:: Microsoft.Data.SqlClient v3.0.1

套件:: Microsoft.Data.SqlClient v3.1.0

套件:: Microsoft.Data.SqlClient v4.0.1

套件:: Microsoft.Data.SqlClient v4.1.0

套件:: Microsoft.Data.SqlClient v5.0.0

套件:: Microsoft.Data.SqlClient v5.1.0

套件:: Microsoft.Data.SqlClient v5.2.0

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

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 屬性。

// <Snippet1>
using System;
using System.Xml;
using System.Data;
using Microsoft.Data.SqlClient;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet DataSet1;
    protected DataGrid dataGrid1;


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

備註

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

屬性	初始值
CommandText	空字串 (「」)
CommandTimeout	30
CommandType	`CommandType.Text`
Connection	Null

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

適用於

SqlCommand(String)

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

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

public SqlCommand (string cmdText);

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

Public Sub New (cmdText As String)

參數

cmdText: String

查詢的文字。

範例

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

using System;
using System.Xml;
using System.Data;
using Microsoft.Data.SqlClient;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet DataSet1;
    protected DataGrid dataGrid1;


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

備註

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

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

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

適用於

SqlCommand(String, SqlConnection)

使用查詢 SqlConnection 和的文字，初始化類別的新實例 SqlCommand 。

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

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

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

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

參數

cmdText: String

查詢的文字。

connection: SqlConnection

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

範例

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

using System;
using System.Data;
using Microsoft.Data.SqlClient;


namespace SqlCommandCS
{
    class Program
    {
        static void Main()
        {
            string str = "Data Source=(local);Initial Catalog=Northwind;"
                + "Integrated Security=SSPI";
            string qs = "SELECT OrderID, CustomerID FROM dbo.Orders;";
            CreateCommand(qs, str);

        }

        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]));
                }
            }
        }

備註

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

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

您可以藉由設定相關屬性來變更上述任何參數的值。

適用於

SqlCommand(String, SqlConnection, SqlTransaction)

使用查詢 SqlConnection 、、和 SqlTransaction 的文字， SqlCommand 初始化類別的新實例。

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

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

new Microsoft.Data.SqlClient.SqlCommand : string * Microsoft.Data.SqlClient.SqlConnection * Microsoft.Data.SqlClient.SqlTransaction -> Microsoft.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` 。

您可以藉由設定相關屬性來變更上述任何參數的值。

適用於

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

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

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

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

new Microsoft.Data.SqlClient.SqlCommand : string * Microsoft.Data.SqlClient.SqlConnection * Microsoft.Data.SqlClient.SqlTransaction * Microsoft.Data.SqlClient.SqlCommandColumnEncryptionSetting -> Microsoft.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。

適用於

共用方式為

SqlCommand 建構函式

定義

多載

SqlCommand()

範例

備註

適用於

SqlCommand(String)

參數

範例

備註

適用於

SqlCommand(String, SqlConnection)

參數

範例

備註

適用於

SqlCommand(String, SqlConnection, SqlTransaction)

參數

備註

適用於

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

參數

適用於

其他資源