SqlCommand コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
SqlCommand() |
SqlCommand クラスの新しいインスタンスを初期化します。 |
SqlCommand(String) |
クエリ テキストを指定して、SqlCommand クラスの新しいインスタンスを初期化します。 |
SqlCommand(String, SqlConnection) |
クエリのテキストと を SqlCommand 使用して、 クラスの新しいインスタンスを SqlConnection 初期化します。 |
SqlCommand(String, SqlConnection, SqlTransaction) |
クエリのテキスト、、および を SqlCommand 使用して、 クラスの新しいインスタンスを SqlConnection 初期化します SqlTransaction 。 |
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 インスタンスが作成されると、次の読み取り/書き込みプロパティが初期値に設定されます。
Properties | 初期値 |
---|---|
CommandText | cmdText |
CommandTimeout | 30 |
CommandType | CommandType.Text |
Connection | null |
これらのプロパティの値は、 プロパティを個別に呼び出して変更できます。
適用対象
SqlCommand(String, SqlConnection)
クエリのテキストと を SqlCommand 使用して、 クラスの新しいインスタンスを SqlConnection 初期化します。
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
SQL Server のインスタンスへの接続を表す SqlConnection。
例
次の例では、 を 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 | パラメーターの値connection である新しい SqlConnection 。 |
これらのパラメーターの値は、関連プロパティを設定することで変更できます。
適用対象
SqlCommand(String, SqlConnection, SqlTransaction)
クエリのテキスト、、および を SqlCommand 使用して、 クラスの新しいインスタンスを SqlConnection 初期化します SqlTransaction 。
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
SQL Server のインスタンスへの接続を表す SqlConnection。
- transaction
- SqlTransaction
SqlCommand が実行される SqlTransaction。
注釈
のインスタンスの初期プロパティ値を次の SqlCommand表に示します。
プロパティ | 初期値 |
---|---|
CommandText | cmdText |
CommandTimeout | 30 |
CommandType | CommandType.Text |
Connection | パラメーターの値connection である新しい SqlConnection 。 |
これらのパラメーターの値は、関連プロパティを設定することで変更できます。
適用対象
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
SQL Server のインスタンスへの接続を表す SqlConnection。
- transaction
- SqlTransaction
SqlCommand が実行される SqlTransaction。
- columnEncryptionSetting
- SqlCommandColumnEncryptionSetting
暗号化の設定。 詳細については、「 Always Encrypted」を参照してください。