OleDbParameter クラス
アセンブリ: System.Data (system.data.dll 内)

Public NotInheritable Class OleDbParameter Inherits DbParameter Implements ICloneable, IDbDataParameter, IDataParameter
public ref class OleDbParameter sealed : public DbParameter, ICloneable, IDbDataParameter, IDataParameter

OLE DB .NET Framework データ プロバイダでは、名前付きパラメータではなく、疑問符 (?) で示される位置指定パラメータが使用されます。
Microsoft OLE DB Provider for Oracle (MSDAORA) と OLE DB .NET Framework データ プロバイダを使用して Oracle データベースに対するクエリを実行する場合、LIKE 句を使用して固定長フィールドの値を問い合わせると、期待される一致したデータがすべて返されないことがあります。これは、Oracle によって LIKE 句の固定長フィールドの値との比較が行われるときに、末尾の空白を含めて、文字列の全長にわたって比較が行われるからです。たとえば、Oracle データベースのテーブルに char(3) として定義されている "Field1" という名前のフィールドが存在し、そのテーブルの行の 1 つに "a" という値を入力した場合、次のコードでは該当する行が返されません。
Dim queryString As String = "SELECT * FROM Table1 WHERE Field1 LIKE ?" Dim command As OleDbCommand = New OleDbCommand(queryString, connection) command.Parameters.Add("@p1", OleDbType.Char, 3).Value = "a" Dim reader As OleDbDataReader = command.ExecuteReader()
string queryString = "SELECT * FROM Table1 WHERE Field1 LIKE ?"; OleDbCommand command = new OleDbCommand(queryString, connection); command.Parameters.Add("@p1", OleDbType.Char, 3).Value = "a"; OleDbDataReader reader = command.ExecuteReader();
これは、Oracle では、3 の固定長に合わせるために "a" に続けて空白を埋めて、列値を "a " として格納しているからです。Oracle は、固定長フィールドの LIKE 比較において、これをパラメータ値 "a" と一致しているとは見なしません。
この問題を解決するには、パーセント ("%") ワイルドカード文字をパラメータ値 ("a%") に追加するか、または代わりに SQL = 比較を使用します。

OleDbDataAdapter の OleDbParameterCollection コレクションを使用して、OleDbParameter の複数のインスタンスを作成する例を次に示します。これらのパラメータは、データ ソースからのデータの選択と、DataSet でのデータの配置に使用されます。この例は、DataSet および OleDbDataAdapter が、正しいスキーマ、コマンド、および接続で既に作成されていることを前提にしています。
Public Function GetDataSetFromAdapter( _ ByVal dataSet As DataSet, ByVal connectionString As String, _ ByVal queryString As String) As DataSet Using connection As New OleDbConnection(connectionString) Dim adapter As New OleDbDataAdapter(queryString, connection) ' Set the parameters. adapter.SelectCommand.Parameters.Add( _ "@CategoryName", OleDbType.VarChar, 80).Value = "toasters" adapter.SelectCommand.Parameters.Add( _ "@SerialNum", OleDbType.Integer).Value = 239 ' Open the connection and fill the DataSet. Try connection.Open() adapter.Fill(dataSet) Catch ex As Exception Console.WriteLine(ex.Message) End Try ' The connection is automatically closed when the ' code exits the Using block. End Using Return dataSet End Function
public DataSet GetDataSetFromAdapter( DataSet dataSet, string connectionString, string queryString) { using (OleDbConnection connection = new OleDbConnection(connectionString)) { OleDbDataAdapter adapter = new OleDbDataAdapter(queryString, connection); // Set the parameters. adapter.SelectCommand.Parameters.Add( "@CategoryName", OleDbType.VarChar, 80).Value = "toasters"; adapter.SelectCommand.Parameters.Add( "@SerialNum", OleDbType.Integer).Value = 239; // Open the connection and fill the DataSet. try { connection.Open(); adapter.Fill(dataSet); } catch (Exception ex) { Console.WriteLine(ex.Message); } // The connection is automatically closed when the // code exits the using block. } return dataSet; }
using System; using System.Data; using System.Data.OleDb; class Class1 { static void Main() { // string x = "Provider=SQLOLEDB;Data Source=(local);Integrated Security=SSPI;Initial Catalog=Northwind"; } public DataSet GetDataSetFromAdapter( DataSet dataSet, string connectionString, string queryString) { using (OleDbConnection connection = new OleDbConnection(connectionString)) { OleDbDataAdapter adapter = new OleDbDataAdapter(queryString, connection); // Set the parameters. adapter.SelectCommand.Parameters.Add( "@CategoryName", OleDbType.VarChar, 80).Value = "toasters"; adapter.SelectCommand.Parameters.Add( "@SerialNum", OleDbType.Integer).Value = 239; // Open the connection and fill the DataSet. try { connection.Open(); adapter.Fill(dataSet); } catch (Exception ex) { Console.WriteLine(ex.Message); } // The connection is automatically closed when the // code exits the using block. } return dataSet; }

System.MarshalByRefObject
System.Data.Common.DbParameter
System.Data.OleDb.OleDbParameter


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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


OleDbParameter コンストラクタ ()
アセンブリ: System.Data (system.data.dll 内)



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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


OleDbParameter コンストラクタ (String, OleDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object)
アセンブリ: System.Data (system.data.dll 内)

Public Sub New ( _ parameterName As String, _ dbType As OleDbType, _ size As Integer, _ direction As ParameterDirection, _ precision As Byte, _ scale As Byte, _ sourceColumn As String, _ sourceVersion As DataRowVersion, _ sourceColumnNullMapping As Boolean, _ value As Object _ )
Dim parameterName As String Dim dbType As OleDbType Dim size As Integer Dim direction As ParameterDirection Dim precision As Byte Dim scale As Byte Dim sourceColumn As String Dim sourceVersion As DataRowVersion Dim sourceColumnNullMapping As Boolean Dim value As Object Dim instance As New OleDbParameter(parameterName, dbType, size, direction, precision, scale, sourceColumn, sourceVersion, sourceColumnNullMapping, value)
public OleDbParameter ( string parameterName, OleDbType dbType, int size, ParameterDirection direction, byte precision, byte scale, string sourceColumn, DataRowVersion sourceVersion, bool sourceColumnNullMapping, Object value )
public: OleDbParameter ( String^ parameterName, OleDbType dbType, int size, ParameterDirection direction, unsigned char precision, unsigned char scale, String^ sourceColumn, DataRowVersion sourceVersion, bool sourceColumnNullMapping, Object^ value )
public OleDbParameter ( String parameterName, OleDbType dbType, int size, ParameterDirection direction, byte precision, byte scale, String sourceColumn, DataRowVersion sourceVersion, boolean sourceColumnNullMapping, Object value )
public function OleDbParameter ( parameterName : String, dbType : OleDbType, size : int, direction : ParameterDirection, precision : byte, scale : byte, sourceColumn : String, sourceVersion : DataRowVersion, sourceColumnNullMapping : boolean, value : Object )
- parameterName
パラメータの名前。
- dbType
OleDbType 値の 1 つ。
- sourceColumn
ソース列の名前。
- sourceVersion
DataRowVersion 値の 1 つ。




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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


OleDbParameter コンストラクタ (String, Object)
アセンブリ: System.Data (system.data.dll 内)


OleDbParameter コンストラクタのこのオーバーロードを使用して整数のパラメータ値を指定する場合は、注意する必要があります。このオーバーロードは Object 型の value を受け取るため、次の C# の例のように、値が 0 の場合に整数値を Object 型に変換する必要があります。
この変換を行わないと、コンパイラは、OleDbParameter コンストラクタ オーバーロードを呼び出そうとしていると見なします。


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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


OleDbParameter コンストラクタ (String, OleDbType)
アセンブリ: System.Data (system.data.dll 内)





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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


OleDbParameter コンストラクタ (String, OleDbType, Int32, String)
アセンブリ: System.Data (system.data.dll 内)

Public Sub New ( _ name As String, _ dataType As OleDbType, _ size As Integer, _ srcColumn As String _ )
Dim name As String Dim dataType As OleDbType Dim size As Integer Dim srcColumn As String Dim instance As New OleDbParameter(name, dataType, size, srcColumn)
public function OleDbParameter ( name : String, dataType : OleDbType, size : int, srcColumn : String )
- srcColumn
ソース列の名前。



OleDbParameter を作成し、そのプロパティの一部を設定する例を次に示します。
Public Sub CreateOleDbParameter() Dim parameter As New OleDbParameter( _ "Description", OleDbType.VarChar, 88, "Description") parameter.Direction = ParameterDirection.Output End Sub
public void CreateOleDbParameter() { OleDbParameter parameter = new OleDbParameter( "Description",OleDbType.VarChar, 88,"Description"); parameter.Direction = ParameterDirection.Output; }

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


OleDbParameter コンストラクタ (String, OleDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)
アセンブリ: System.Data (system.data.dll 内)

Public Sub New ( _ parameterName As String, _ dbType As OleDbType, _ size As Integer, _ direction As ParameterDirection, _ isNullable As Boolean, _ precision As Byte, _ scale As Byte, _ srcColumn As String, _ srcVersion As DataRowVersion, _ value As Object _ )
Dim parameterName As String Dim dbType As OleDbType Dim size As Integer Dim direction As ParameterDirection Dim isNullable As Boolean Dim precision As Byte Dim scale As Byte Dim srcColumn As String Dim srcVersion As DataRowVersion Dim value As Object Dim instance As New OleDbParameter(parameterName, dbType, size, direction, isNullable, precision, scale, srcColumn, srcVersion, value)
public OleDbParameter ( string parameterName, OleDbType dbType, int size, ParameterDirection direction, bool isNullable, byte precision, byte scale, string srcColumn, DataRowVersion srcVersion, Object value )
public: OleDbParameter ( String^ parameterName, OleDbType dbType, int size, ParameterDirection direction, bool isNullable, unsigned char precision, unsigned char scale, String^ srcColumn, DataRowVersion srcVersion, Object^ value )
public OleDbParameter ( String parameterName, OleDbType dbType, int size, ParameterDirection direction, boolean isNullable, byte precision, byte scale, String srcColumn, DataRowVersion srcVersion, Object value )
public function OleDbParameter ( parameterName : String, dbType : OleDbType, size : int, direction : ParameterDirection, isNullable : boolean, precision : byte, scale : byte, srcColumn : String, srcVersion : DataRowVersion, value : Object )
- parameterName
パラメータの名前。
- dbType
OleDbType 値の 1 つ。
- srcColumn
ソース列の名前。
- srcVersion
DataRowVersion 値の 1 つ。




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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


OleDbParameter コンストラクタ

名前 | 説明 |
---|---|
OleDbParameter () | OleDbParameter クラスの新しいインスタンスを初期化します。 |
OleDbParameter (String, Object) | パラメータ名と新しい OleDbParameter の値を指定して、OleDbParameter クラスの新しいインスタンスを初期化します。 |
OleDbParameter (String, OleDbType) | パラメータ名とデータ型を指定して、OleDbParameter クラスの新しいインスタンスを初期化します。 |
OleDbParameter (String, OleDbType, Int32) | パラメータ名、データ型、および長さを指定して、OleDbParameter クラスの新しいインスタンスを初期化します。 |
OleDbParameter (String, OleDbType, Int32, String) | パラメータ名、データ型、長さ、およびソース列名を指定して、OleDbParameter クラスの新しいインスタンスを初期化します。 |
OleDbParameter (String, OleDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object) | パラメータの名前、データ型、長さ、ソース列名、パラメータの方向、数値の精度、およびその他のプロパティを指定して、OleDbParameter クラスの新しいインスタンスを初期化します。 |
OleDbParameter (String, OleDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object) | パラメータの名前、データ型、長さ、ソース列名、パラメータの方向、数値の精度、およびその他のプロパティを指定して、OleDbParameter クラスの新しいインスタンスを初期化します。 |

OleDbParameter コンストラクタ (String, OleDbType, Int32)
アセンブリ: System.Data (system.data.dll 内)

Dim name As String Dim dataType As OleDbType Dim size As Integer Dim instance As New OleDbParameter(name, dataType, size)




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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


OleDbParameter プロパティ

名前 | 説明 | |
---|---|---|
![]() | DbType | オーバーライドされます。 パラメータの DbType を取得または設定します。 |
![]() | Direction | オーバーライドされます。 パラメータが入力専用、出力専用、双方向、またはストアド プロシージャの戻り値パラメータかどうかを示す値を取得または設定します。 |
![]() | IsNullable | オーバーライドされます。 パラメータが null 値を受け付けるかどうかを示す値を取得または設定します。 |
![]() | OleDbType | パラメータの OleDbType を取得または設定します。 |
![]() | ParameterName | オーバーライドされます。 OleDbParameter の名前を取得または設定します。 |
![]() | Precision | Value プロパティを表すときに使用する最大桁数を取得または設定します。 |
![]() | Scale | Value を解決するための小数部桁数を取得または設定します。 |
![]() | Size | オーバーライドされます。 列内のデータの最大サイズをバイト単位で取得または設定します。 |
![]() | SourceColumn | オーバーライドされます。 DataSet に割り当てられ、Value の読み込みまたは戻しに使用されるソース列の名前を取得または設定します。 |
![]() | SourceColumnNullMapping | オーバーライドされます。 ソース列が null 許容であるかどうかを示す値を設定または取得します。DbCommandBuilder は、これを使用することにより、null 許容列に対する Update ステートメントを正しく生成できます。 |
![]() | SourceVersion | オーバーライドされます。 Value の読み込み時に使用する DataRowVersion を取得または設定します。 |
![]() | Value | オーバーライドされます。 パラメータの値を取得または設定します。 |

OleDbParameter メソッド

名前 | 説明 | |
---|---|---|
![]() | CreateObjRef | リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。) |
![]() | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
![]() | GetLifetimeService | 対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。) |
![]() | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
![]() | InitializeLifetimeService | 対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。) |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
![]() | ResetDbType | オーバーライドされます。 この OleDbParameter に関連付けられている型をリセットします。 |
![]() | ResetOleDbType | この OleDbParameter に関連付けられている型をリセットします。 |
![]() | ToString | オーバーライドされます。 ParameterName を格納する文字列を取得します。 |

名前 | 説明 | |
---|---|---|
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
![]() | MemberwiseClone | オーバーロードされます。 ( MarshalByRefObject から継承されます。) |


OleDbParameter メンバ
OleDbCommand のパラメータと、オプションとして DataSet 列に対するマップを表します。このクラスは継承できません。
OleDbParameter データ型で公開されるメンバを以下の表に示します。


名前 | 説明 | |
---|---|---|
![]() | DbType | オーバーライドされます。 パラメータの DbType を取得または設定します。 |
![]() | Direction | オーバーライドされます。 パラメータが入力専用、出力専用、双方向、またはストアド プロシージャの戻り値パラメータかどうかを示す値を取得または設定します。 |
![]() | IsNullable | オーバーライドされます。 パラメータが null 値を受け付けるかどうかを示す値を取得または設定します。 |
![]() | OleDbType | パラメータの OleDbType を取得または設定します。 |
![]() | ParameterName | オーバーライドされます。 OleDbParameter の名前を取得または設定します。 |
![]() | Precision | Value プロパティを表すときに使用する最大桁数を取得または設定します。 |
![]() | Scale | Value を解決するための小数部桁数を取得または設定します。 |
![]() | Size | オーバーライドされます。 列内のデータの最大サイズをバイト単位で取得または設定します。 |
![]() | SourceColumn | オーバーライドされます。 DataSet に割り当てられ、Value の読み込みまたは戻しに使用されるソース列の名前を取得または設定します。 |
![]() | SourceColumnNullMapping | オーバーライドされます。 ソース列が null 許容であるかどうかを示す値を設定または取得します。DbCommandBuilder は、これを使用することにより、null 許容列に対する Update ステートメントを正しく生成できます。 |
![]() | SourceVersion | オーバーライドされます。 Value の読み込み時に使用する DataRowVersion を取得または設定します。 |
![]() | Value | オーバーライドされます。 パラメータの値を取得または設定します。 |

名前 | 説明 | |
---|---|---|
![]() | CreateObjRef | リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。) |
![]() | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
![]() | GetLifetimeService | 対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。) |
![]() | GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
![]() | InitializeLifetimeService | 対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。) |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
![]() | ResetDbType | オーバーライドされます。 この OleDbParameter に関連付けられている型をリセットします。 |
![]() | ResetOleDbType | この OleDbParameter に関連付けられている型をリセットします。 |
![]() | ToString | オーバーライドされます。 ParameterName を格納する文字列を取得します。 |

名前 | 説明 | |
---|---|---|
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
![]() | MemberwiseClone | オーバーロードされます。 ( MarshalByRefObject から継承されます。) |


Weblioに収録されているすべての辞書からOleDbParameterを検索する場合は、下記のリンクをクリックしてください。

- OleDbParameterのページへのリンク