sqlcommandとは? わかりやすく解説

SqlCommand イベント


SqlCommand クラス

SQL Server データベースに対して実行する Transact-SQL ステートメントまたはストアド プロシージャ表します。このクラス継承できません。

名前空間: System.Data.SqlClient
アセンブリ: System.Data (system.data.dll 内)
構文構文

Public NotInheritable Class
 SqlCommand
    Inherits DbCommand
    Implements ICloneable
public sealed class SqlCommand : DbCommand,
 ICloneable
public ref class SqlCommand sealed : public
 DbCommand, ICloneable
public final class SqlCommand extends DbCommand
 implements ICloneable
public final class SqlCommand extends
 DbCommand implements ICloneable
解説解説

SqlCommandインスタンス作成すると、読み書き可能プロパティ初期値設定されます。これらの初期値一覧については、SqlCommand コンストラクタトピック参照してください

SqlCommand には、SQL Server データベースコマンド実行するための、次のメソッドあります

項目

説明

BeginExecuteNonQuery

この SqlCommand によって定義されTransact-SQL ステートメントまたはストアド プロシージャ非同期実行開始します通常INSERTDELETEUPDATESET ステートメントなどのコマンド実行されます。BeginExecuteNonQuery は必ず EndExecuteNonQuery とペア呼び出し通常スレッドごとに、操作完了させる必要があります

BeginExecuteReader

この SqlCommand によって定義されTransact-SQL ステートメントまたはストアド プロシージャ非同期実行開始しサーバーから 1 つまたは複数結果取得しますBeginExecuteReader は必ず EndExecuteReader とペア呼び出し通常スレッドごとに、操作完了させる必要があります

BeginExecuteXmlReader

この SqlCommand によって定義されTransact-SQL ステートメントまたはストアド プロシージャ非同期実行開始しますBeginExecuteXmlReaderEndExecuteXmlReaderペア呼び出す必要があります。これによって、通常スレッドごとに操作完了しXmlReader オブジェクト取得できます

ExecuteReader

行を返すコマンド実行しますパフォーマンス高めるために、ExecuteReaderTransact-SQL sp_executesql システム ストアド プロシージャ使用してコマンド呼び出します。そのため、Transact-SQL SET ステートメントなどのコマンド実行ExecuteReader使用すると、期待した効果得られないことがあります

ExecuteNonQuery

Transact-SQLINSERT、DELELE、UPDATESET の各ステートメントなどのコマンド実行します

ExecuteScalar

データベースから単一の値 (集計値など) を取得します

ExecuteXmlReader

CommandText を Connection送信しXmlReader オブジェクト構築します

CommandText プロパティリセットして、SqlCommand オブジェクト再利用できます。ただし、新規コマンドまたは以前コマンド実行する前に、SqlDataReader を閉じる必要があります

SqlCommand実行するメソッドが SqlException を生成した場合重大度レベル19 以下のときは、SqlConnection は開いたままになります重大度レベル20上のときは、通常サーバーSqlConnection閉じます。ただし、ユーザー接続を再び開いて、処理を継続できます

使用例使用例

SqlConnectionSqlCommand、および SqlDataReader作成する例を次に示します。この例では、データ読み取りコンソール出力します最後に、この例では SqlDataReader閉じてから、SqlConnection閉じます

Public Sub ReadOrderData(ByVal
 connectionString As String)
    Dim queryString As String
 = _
        "SELECT OrderID, CustomerID FROM dbo.Orders;"
    Using connection As New SqlConnection(connectionString)
        Dim command As New
 SqlCommand(queryString, connection)
        connection.Open()
        Dim reader As SqlDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine(String.Format("{0},
 {1}", _
                    reader(0), reader(1)))
            End While
        Finally
            ' Always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub
private static void ReadOrderData(string
 connectionString)
{
    string queryString = 
        "SELECT OrderID, CustomerID FROM dbo.Orders;";
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(
            queryString, connection);
        connection.Open();
        SqlDataReader reader = command.ExecuteReader();
        try
        {
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}, {1}",
                    reader[0], reader[1]));
            }
        }
        finally
        {
            // Always call Close when done reading.
            reader.Close();
        }
    }
}
継承階層継承階層
System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbCommand
        System.Data.SqlClient.SqlCommand
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバ場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

SqlCommand コンストラクタ ()

SqlCommand クラス新しインスタンス初期化します。

名前空間: System.Data.SqlClient
アセンブリ: System.Data (system.data.dll 内)
構文構文

public SqlCommand ()
public:
SqlCommand ()
public SqlCommand ()
解説解説
使用例使用例

SqlCommand作成し、その CommandTimeout プロパティ設定する例を次に示します

Public Sub CreateSqlCommand()
    Dim command As New SqlCommand()
    command.CommandTimeout = 15
    command.CommandType = CommandType.Text
End Sub
public void CreateSqlCommand() 
{
   SqlCommand command = new SqlCommand();
   command.CommandTimeout = 15;
   command.CommandType = CommandType.Text;
}
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

SqlCommand コンストラクタ (String, SqlConnection, SqlTransaction)

クエリ テキストSqlConnection、および SqlTransaction指定してSqlCommand クラス新しインスタンス初期化します。

名前空間: System.Data.SqlClient
アセンブリ: System.Data (system.data.dll 内)
構文構文

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

Dim instance As New SqlCommand(cmdText,
 connection, transaction)
public SqlCommand (
    string cmdText,
    SqlConnection connection,
    SqlTransaction transaction
)
public:
SqlCommand (
    String^ cmdText, 
    SqlConnection^ connection, 
    SqlTransaction^ transaction
)
public SqlCommand (
    String cmdText, 
    SqlConnection connection, 
    SqlTransaction transaction
)
public function SqlCommand (
    cmdText : String, 
    connection : SqlConnection, 
    transaction : SqlTransaction
)

パラメータ

cmdText

クエリ テキスト

connection

SQL Serverインスタンスへの接続を表す SqlConnection。

transaction

SqlCommand の実行対象の SqlTransaction。

解説解説

SqlCommandインスタンス初期プロパティ値を次の表に示します

プロパティ

初期値

CommandText

cmdText

CommandTimeout

30

CommandType

CommandType.Text

Connection

connection パラメータの値である新しSqlConnection

これらのパラメータの値は、関連するプロパティ設定することによって変更できます

プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

SqlCommand コンストラクタ (String, SqlConnection)

クエリ テキストSqlConnection指定して、SqlCommand クラス新しインスタンス初期化します。

名前空間: System.Data.SqlClient
アセンブリ: System.Data (system.data.dll 内)
構文構文

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

Dim instance As New SqlCommand(cmdText,
 connection)
public SqlCommand (
    string cmdText,
    SqlConnection connection
)
public:
SqlCommand (
    String^ cmdText, 
    SqlConnection^ connection
)
public SqlCommand (
    String cmdText, 
    SqlConnection connection
)
public function SqlCommand (
    cmdText : String, 
    connection : SqlConnection
)

パラメータ

cmdText

クエリ テキスト

connection

SQL Serverインスタンスへの接続を表す SqlConnection。

解説解説

SqlCommandインスタンス初期プロパティ値を次の表に示します

プロパティ

初期値

CommandText

cmdText

CommandTimeout

30

CommandType

CommandType.Text

Connection

connection パラメータの値である新しSqlConnection

これらのパラメータの値は、関連するプロパティ設定することによって変更できます

使用例使用例

SqlCommand作成し、そのプロパティ一部設定する例を次に示します

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
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 コンストラクタ (String)

クエリ テキスト指定して、SqlCommand クラス新しインスタンス初期化します。

名前空間: System.Data.SqlClient
アセンブリ: System.Data (system.data.dll 内)
構文構文

Public Sub New ( _
    cmdText As String _
)
Dim cmdText As String

Dim instance As New SqlCommand(cmdText)
public SqlCommand (
    string cmdText
)
public:
SqlCommand (
    String^ cmdText
)
public SqlCommand (
    String cmdText
)
public function SqlCommand (
    cmdText : String
)

パラメータ

cmdText

クエリ テキスト

解説解説
使用例使用例

接続文字列コマンド テキスト渡してSqlCommand作成する例を次に示します

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 
public void CreateCommand() 
 {
    string queryString = "SELECT * FROM Categories ORDER
 BY CategoryID";
    SqlCommand command = new SqlCommand(queryString);
    command.CommandTimeout = 15;
    command.CommandType = CommandType.Text;
 }
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

SqlCommand コンストラクタ

SqlCommand クラス新しインスタンス初期化します。
オーバーロードの一覧オーバーロードの一覧

参照参照

関連項目

SqlCommand クラス
SqlCommand メンバ
System.Data.SqlClient 名前空間

その他の技術情報

ADO.NET でのデータへの接続およびデータ取得
.NET Framework Data Provider for SQL Server使用

SqlCommand プロパティ


パブリック プロパティパブリック プロパティ

プロテクト プロパティプロテクト プロパティ
明示的インターフェイスの実装明示的インターフェイス実装
  名前 説明
インターフェイスの明示的な実装 System.Data.IDbCommand.Transaction  
参照参照

関連項目

SqlCommand クラス
System.Data.SqlClient 名前空間

その他の技術情報

ADO.NET でのデータへの接続およびデータ取得
.NET Framework Data Provider for SQL Server使用

SqlCommand メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド参照)
  名前 説明
パブリック メソッド BeginExecuteNonQuery オーバーロードされます。 この SqlCommand によって定義されTransact-SQL ステートメントまたはストアド プロシージャ非同期実行開始します
パブリック メソッド BeginExecuteReader オーバーロードされます。 この SqlCommand によって定義されTransact-SQL ステートメントまたはストアド プロシージャ非同期実行開始しサーバーから 1 つまたは複数結果取得します
パブリック メソッド BeginExecuteXmlReader オーバーロードされます。 この SqlCommand によって定義されTransact-SQL ステートメントまたはストアド プロシージャ非同期実行開始し結果XmlReader オブジェクトとして返します
パブリック メソッド Cancel オーバーライドされますSqlCommand実行キャンセル試行します。
パブリック メソッド Clone 現在のインスタンスコピーである新しSqlCommand オブジェクト作成します
パブリック メソッド CreateObjRef  リモート オブジェクトとの通信使用するプロキシ生成必要な情報をすべて格納しているオブジェクト作成します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド CreateParameter SqlParameter オブジェクト新しインスタンス作成します
パブリック メソッド Dispose  オーバーロードされますComponent によって使用されているリソース解放します。 ( Component から継承されます。)
パブリック メソッド EndExecuteNonQuery Transact-SQL ステートメント非同期実行完了します
パブリック メソッド EndExecuteReader Transact-SQL ステートメント非同期実行完了し要求された SqlDataReader を返します
パブリック メソッド EndExecuteXmlReader Transact-SQL ステートメント非同期実行完了し要求されデータXML として返します
パブリック メソッド Equals  オーバーロードされます2 つObject インスタンス等しかどうか判断します。 ( Object から継承されます。)
パブリック メソッド ExecuteNonQuery オーバーライドされます接続に対して Transact-SQL ステートメント実行し影響受けた行数返します
パブリック メソッド ExecuteReader オーバーロードされます。 CommandText を Connection送信しSqlDataReader構築します
パブリック メソッド ExecuteScalar オーバーライドされますクエリ実行し、そのクエリ返す結果セット最初の行にある最初の列を返します残りの列または行は無視されます。
パブリック メソッド ExecuteXmlReader CommandTextConnection送信しXmlReader オブジェクト構築します
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用適してます。 ( Object から継承されます。)
パブリック メソッド GetLifetimeService  対象インスタンス有効期間ポリシー制御する現在の有効期間サービス オブジェクト取得します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド GetType  現在のインスタンスType取得します。 ( Object から継承されます。)
パブリック メソッド InitializeLifetimeService  対象インスタンス有効期間ポリシー制御する有効期間サービス オブジェクト取得します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド Prepare オーバーライドされますSQL Serverインスタンス対す準備済みコマンド作成します
パブリック メソッド ReferenceEquals  指定した複数Object インスタンス同一かどうか判断します。 ( Object から継承されます。)
パブリック メソッド ResetCommandTimeout CommandTimeout プロパティ既定値リセットします。
パブリック メソッド ToString  Component の名前を格納している String返します (存在する場合)。このメソッドオーバーライドできません。 ( Component から継承されます。)
プロテクト メソッドプロテクト メソッド
明示的インターフェイスの実装明示的インターフェイス実装
  名前 説明
インターフェイスの明示的な実装 System.Data.IDbCommand.ExecuteReader オーバーロードされます。  
インターフェイスの明示的な実装 System.IDisposable.Dispose  
参照参照

関連項目

SqlCommand クラス
System.Data.SqlClient 名前空間

その他の技術情報

ADO.NET でのデータへの接続およびデータ取得
.NET Framework Data Provider for SQL Server使用

SqlCommand メンバ

SQL Server データベースに対して実行する Transact-SQL ステートメントまたはストアド プロシージャ表します。このクラス継承できません。

SqlCommand データ型公開されるメンバを以下の表に示します


パブリック コンストラクタパブリック コンストラクタ
パブリック プロパティパブリック プロパティ
プロテクト プロパティプロテクト プロパティ
パブリック メソッドパブリック メソッド
( プロテクト メソッド参照)
  名前 説明
パブリック メソッド BeginExecuteNonQuery オーバーロードされます。 この SqlCommand によって定義されTransact-SQL ステートメントまたはストアド プロシージャ非同期実行開始します
パブリック メソッド BeginExecuteReader オーバーロードされます。 この SqlCommand によって定義されTransact-SQL ステートメントまたはストアド プロシージャ非同期実行開始しサーバーから 1 つまたは複数結果取得します
パブリック メソッド BeginExecuteXmlReader オーバーロードされます。 この SqlCommand によって定義されTransact-SQL ステートメントまたはストアド プロシージャ非同期実行開始し結果XmlReader オブジェクトとして返します
パブリック メソッド Cancel オーバーライドされますSqlCommand実行キャンセル試行します。
パブリック メソッド Clone 現在のインスタンスコピーである新しSqlCommand オブジェクト作成します
パブリック メソッド CreateObjRef  リモート オブジェクトとの通信使用するプロキシ生成必要な情報をすべて格納しているオブジェクト作成します。 (MarshalByRefObject から継承されます。)
パブリック メソッド CreateParameter SqlParameter オブジェクト新しインスタンス作成します
パブリック メソッド Dispose  オーバーロードされますComponent によって使用されているリソース解放します。 (Component から継承されます。)
パブリック メソッド EndExecuteNonQuery Transact-SQL ステートメント非同期実行完了します
パブリック メソッド EndExecuteReader Transact-SQL ステートメント非同期実行完了し要求された SqlDataReader を返します
パブリック メソッド EndExecuteXmlReader Transact-SQL ステートメント非同期実行完了し要求されデータXML として返します
パブリック メソッド Equals  オーバーロードされます2 つObject インスタンス等しかどうか判断します。 (Object から継承されます。)
パブリック メソッド ExecuteNonQuery オーバーライドされます接続に対して Transact-SQL ステートメント実行し影響受けた行数返します
パブリック メソッド ExecuteReader オーバーロードされます。 CommandText を Connection送信しSqlDataReader構築します
パブリック メソッド ExecuteScalar オーバーライドされますクエリ実行し、そのクエリ返す結果セット最初の行にある最初の列を返します残りの列または行は無視されます。
パブリック メソッド ExecuteXmlReader CommandTextConnection送信しXmlReader オブジェクト構築します
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用適してます。 (Object から継承されます。)
パブリック メソッド GetLifetimeService  対象インスタンス有効期間ポリシー制御する現在の有効期間サービス オブジェクト取得します。 (MarshalByRefObject から継承されます。)
パブリック メソッド GetType  現在のインスタンスType取得します。 (Object から継承されます。)
パブリック メソッド InitializeLifetimeService  対象インスタンス有効期間ポリシー制御する有効期間サービス オブジェクト取得します。 (MarshalByRefObject から継承されます。)
パブリック メソッド Prepare オーバーライドされますSQL Serverインスタンス対す準備済みコマンド作成します
パブリック メソッド ReferenceEquals  指定した複数Object インスタンス同一かどうか判断します。 (Object から継承されます。)
パブリック メソッド ResetCommandTimeout CommandTimeout プロパティ既定値リセットします。
パブリック メソッド ToString  Component の名前を格納している String返します (存在する場合)。このメソッドオーバーライドできません。 (Component から継承されます。)
プロテクト メソッドプロテクト メソッド
パブリック イベントパブリック イベント
明示的インターフェイスの実装明示的インターフェイス実装
  名前 説明
インターフェイスの明示的な実装 System.Data.IDbCommand.ExecuteReader オーバーロードされます。  
インターフェイスの明示的な実装 System.Data.IDbCommand.Transaction  
参照参照

関連項目

SqlCommand クラス
System.Data.SqlClient 名前空間

その他の技術情報

ADO.NET でのデータへの接続およびデータ取得
.NET Framework Data Provider for SQL Server使用



英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

すべての辞書の索引

「sqlcommand」の関連用語

sqlcommandのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



sqlcommandのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2024 Microsoft.All rights reserved.

©2024 GRAS Group, Inc.RSS