OleDbCommand クラス

.NET Framework クラス ライブラリ リファレンス

OleDbCommand クラス

データ ソースに対して実行する SQL ステートメントまたはストアド プロシージャを表します。

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

Visual Basic (宣言)

Public NotInheritable Class
 OleDbCommand
    Inherits DbCommand
    Implements ICloneable, IDbCommand, IDisposable

Visual Basic (使用法)

Dim instance As OleDbCommand

C#

public sealed class OleDbCommand : DbCommand,
 ICloneable, IDbCommand, IDisposable

C++

public ref class OleDbCommand sealed : public
 DbCommand, ICloneable, IDbCommand, IDisposable

J#

public final class OleDbCommand extends DbCommand
 implements ICloneable, IDbCommand, 
    IDisposable

JScript

public final class OleDbCommand extends
 DbCommand implements ICloneable, IDbCommand, 
    IDisposable

解説

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

OleDbCommand には、データ ソースに対してコマンドを実行するための、次のメソッドがあります。

項目	説明
ExecuteReader	行を返すコマンドを実行します。SQL SET ステートメントなどのコマンドの実行に ExecuteReader 使用すると、期待した効果が得られないことがあります。
ExecuteNonQuery	SQL の INSERT、DELETE、UPDATE、SET ステートメントなどのコマンドを実行します。
ExecuteScalar	データベースから単一の値 (集計値など) を取得します。

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

OleDbCommand を実行したメソッドで、致命的な OleDbException (SQL Server の重大度レベルが 20 以上など) が発生した場合は、OleDbConnection 接続が閉じられることがあります。ただし、ユーザーが接続を再び開いて、処理を継続できます。

使用例

OleDbCommand を OleDbDataAdapter および OleDbConnection と共に使用して、Access データベースから行を選択する例を次に示します。次に、格納された DataSet が返されます。この例のコードには、初期化済みの DataSet、接続文字列、クエリ文字列 (SQL SELECT ステートメント)、およびソース データベース テーブル名の文字列が渡されます。

Visual Basic

Public Sub ReadMyData(ByVal
 connectionString As String)
    Dim queryString As String
 = "SELECT OrderID, CustomerID FROM Orders"
    Using connection As New OleDbConnection(connectionString)
        Dim command As New
 OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader.GetInt32(0).ToString() + ",
 " _
               + reader.GetString(1))
        End While

        ' always call Close when done reading.
        reader.Close()
    End Using
End Sub

C#

public void ReadMyData(string
 connectionString)
{
    string queryString = "SELECT OrderID, CustomerID FROM
 Orders";
    using (OleDbConnection connection = new
 OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);
        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetString(1));
        }
        // always call Close when done reading.
        reader.Close();
    }

C#

using System;
using System.Data;
using System.Data.OleDb;

class Class1
{
    static void Main()
    {
    }

    public void ReadMyData(string
 connectionString)
    {
        string queryString = "SELECT OrderID, CustomerID FROM
 Orders";
        using (OleDbConnection connection = new
 OleDbConnection(connectionString))
        {
            OleDbCommand command = new OleDbCommand(queryString,
 connection);
            connection.Open();
            OleDbDataReader reader = command.ExecuteReader();

            while (reader.Read())
            {
                Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetString(1));
            }
            // always call Close when done reading.
            reader.Close();
        }

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbCommand
        System.Data.OleDb.OleDbCommand

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
OleDbCommand メンバ
System.Data.OleDb 名前空間
OleDbDataAdapter
OleDbConnection
その他の技術情報
コマンドの使用