ヘッダーをスキップ

Oracle® Data Provider for .NET開発者ガイド
リリース9.2.0.4

部品番号 B13807-01
Go To Table Of Contents
目次
Go To Index
索引

Go to previous page Go to beginning of chapter Go to next page

Oracle.DataAccess.Clientネームスペース、16/30


OracleParameterCollectionクラス

OracleParameterCollectionクラスは、OracleCommandオブジェクトに関連するすべてのパラメータのコレクション、およびDataSet列に対するマッピングを表します。

クラスの継承

Object

  MarshalByRefObject

    OracleParameterCollection

宣言
// C#
public sealed class OracleParameterCollection : MarshalByRefObject,
  IDataParameterCollection, IList, ICollection, IEnumerable
スレッド・セーフティ

インスタンス・メソッドではスレッド・セーフティを保証しませんが、すべてのpublic staticメソッドはスレッド・セーフです。

備考

OracleParameterCollectionに追加されたOracleParameterの位置は、SQL文のバインド位置です。位置は0から始まり、位置バインドでのみ使用されます。名前付きバインドが使用される場合は、OracleParameterCollectionOracleParameterの位置は無視されます。

// C#
string conStr = "User Id=scott;Password=tiger;Data Source=oracle";

// Create the OracleConnection
OracleConnection con = new OracleConnection(conStr);
con.Open();

// Create the OracleCommand
OracleCommand cmd = new OracleCommand();
cmd.Connection = con;

// Create OracleParameter
OracleParameter [] prm = new OracleParameter[3];

// Bind parameters
prm[0] = cmd.Parameters.Add("paramEmpno", OracleDbType.Decimal, 1234,
    ParameterDirection.Input);
prm[1] = cmd.Parameters.Add("paramEname", OracleDbType.Varchar2,
    "Client", ParameterDirection.Input);
prm[2] = cmd.Parameters.Add("paramDeptNo", OracleDbType.Decimal,
    10, ParameterDirection.Input);

cmd.CommandText = "insert into emp(empno, ename, deptno) values(:1, :2, :3)";
cmd.ExecuteNonQuery();

// Remove OracleParameter objects from the collection
cmd.Parameters.Clear();

// Dispose OracleCommand object
cmd.Dispose();

// Close and Dispose OracleConnection object
con.Close();
con.Dispose();

要件

ネームスペース: Oracle.DataAccess.Client

アセンブリ: Oracle.DataAccess.dll

関連項目:

OracleParameterCollectionのメンバー

OracleParameterCollectionのメンバーを次の表に示します。

OracleParameterCollectionのstaticメソッド

OracleParameterCollectionのstaticメソッドを表4-92に示します。

表4-92 OracleParameterCollectionのstaticメソッド 
メソッド 説明

Equals

Objectから継承されます(オーバーロード)。

OracleParameterCollectionのプロパティ

OracleParameterCollectionのプロパティを表4-93に示します。

表4-93 OracleParameterCollectionのプロパティ 
名前 説明

Count

コレクション内のOracleParameterの数を指定します。

Item

OracleParameterオブジェクトを取得および設定します(オーバーロード)。

OracleParameterCollectionのpublicメソッド

OracleParameterCollectionのpublicメソッドを表4-94に示します。

表4-94 OracleParameterCollectionのpublicメソッド 
publicメソッド 説明

Add

オブジェクトをコレクションに追加します(オーバーロード)。

Clear

コレクションからすべてのOracleParameterを削除します。

Contains

コレクションにオブジェクトが存在するかどうかを示します(オーバーロード)。

CopyTo

指定された配列の指定されたインデックスを開始位置として、コレクションからOracleParameterオブジェクトをコピーします。

CreateObjRef

MarshalByRefObjectから継承されます。

Equals

Objectから継承されます(オーバーロード)。

GetHashCode

Objectから継承されます。

GetLifetimeService

MarshalByRefObjectから継承されます。

GetType

Objectから継承されます。

InitializeLifetimeService

MarshalByRefObjectから継承されます。

IndexOf

コレクション内のオブジェクトのインデックスを返します(オーバーロード)。

Insert

指定されたOracleParameterを、コレクションの指定されたインデックス位置に挿入します。

Remove

コレクションからオブジェクトを削除します。

RemoveAt

位置によってコレクションからオブジェクトを削除します(オーバーロード)。

ToString

Objectから継承されます。

関連項目:

OracleParameterCollectionのstaticメソッド

OracleParameterCollectionのstaticメソッドを表4-95に示します。

表4-95 OracleParameterCollectionのstaticメソッド 
メソッド 説明

Equals

Objectから継承されます(オーバーロード)。

関連項目:

OracleParameterCollectionのプロパティ

OracleParameterCollectionのプロパティを表4-96に示します。

表4-96 OracleParameterCollectionのプロパティ 
名前 説明

Count

コレクション内のOracleParameterの数を指定します。

Item

OracleParameterオブジェクトを取得および設定します(オーバーロード)。

関連項目:

Count

このプロパティは、コレクション内のOracleParameterの数を指定します。

宣言
// C#
public int Count {get;}
プロパティ値

OracleParameterオブジェクトの数

実装

ICollection

備考

デフォルトは0です。

関連項目:

Item

Itemは、OracleParameterオブジェクトを取得および設定します。

オーバーロード一覧:

Item[int]

このプロパティは、指定されたparameterIndexによって指定されたインデックスにあるOracleParameterオブジェクトを取得および設定します。

宣言
// C#
public object Item[int parameterIndex] {get; set;}
プロパティ値

オブジェクト

実装

IList

例外

IndexOutOfRangeException: 指定されたインデックスが存在しません。

備考

OracleParameterCollectionクラスは0から始まるインデックスです。

関連項目:

Item [string]

このプロパティは、指定されたparameterNameによって指定されたパラメータ名を使用して、OracleParameterオブジェクトを取得および設定します。

宣言
// C#
public OracleParameter Item[string parameterName] {get; set;};
プロパティ値

OracleParameter

実装

IDataParameterCollection

例外

IndexOutOfRangeException: 指定されたパラメータ名が存在しません。

関連項目:

OracleParameterCollectionのpublicメソッド

OracleParameterCollectionのpublicメソッドを表4-97に示します。

表4-97 OracleParameterCollectionのpublicメソッド 
publicメソッド 説明

Add

オブジェクトをコレクションに追加します(オーバーロード)。

Clear

コレクションからすべてのOracleParameterを削除します。

Contains

コレクションにオブジェクトが存在するかどうかを示します(オーバーロード)。

CopyTo

指定された配列の指定されたインデックスを開始位置として、コレクションからOracleParameterオブジェクトをコピーします。

CreateObjRef

MarshalByRefObjectから継承されます。

Equals

Objectから継承されます(オーバーロード)。

GetHashCode

Objectから継承されます。

GetLifetimeService

MarshalByRefObjectから継承されます。

GetType

Objectから継承されます。

InitializeLifetimeService

MarshalByRefObjectから継承されます。

IndexOf

コレクション内のオブジェクトのインデックスを返します(オーバーロード)。

Insert

指定されたOracleParameterを、コレクションの指定されたインデックス位置に挿入します。

Remove

コレクションからオブジェクトを削除します。

RemoveAt

位置によってコレクションからオブジェクトを削除します(オーバーロード)。

ToString

Objectから継承されます。

関連項目:

Add

Addは、オブジェクトをコレクションに追加します。

オーバーロード一覧:

Add(object)

このメソッドは、指定されたオブジェクトをコレクションに追加します。

宣言
// C#
public int Add(object obj);
パラメータ
戻り値

新規のOracleParameterが追加されるインデックス

実装

IList

備考

InvalidCastException: 指定されたobjOracleParameterオブジェクトにキャストできません。

関連項目:

Add(OracleParameter)

このメソッドは、指定されたOracleParameterオブジェクトをコレクションに追加します。

宣言
// C#
public OracleParameter Add(OracleParameter paramObj);
パラメータ
戻り値

コレクションに追加された、新しく作成されたOracleParameterオブジェクト

関連項目:

Add(string, object)

このメソッドは、指定された名前およびオブジェクト値を使用して、OracleParameterオブジェクトをコレクションに追加します。

宣言
// C#
public OracleParameter Add(string name, object val);
パラメータ
戻り値

コレクションに追加された、新しく作成されたOracleParameterオブジェクト

関連項目:

Add(string, OracleDbType)

このメソッドは、指定された名前およびデータベース型を使用して、OracleParameterオブジェクトをコレクションに追加します。

宣言
// C#
public OracleParameter Add(string name, OracleDbType dbType);
パラメータ
戻り値

コレクションに追加された、新しく作成されたOracleParameterオブジェクト

関連項目:

Add(string, OracleDbType, ParameterDirection)

このメソッドは、指定された名前、データベース型および方向を使用して、OracleParameterオブジェクトをコレクションに追加します。

宣言
// C#
public OracleParameter Add(string name, OracleDbType dbType, ParameterDirection
direction);
パラメータ
戻り値

コレクションに追加された、新しく作成されたOracleParameterオブジェクト

関連項目:

Add(string, OracleDbType, object, ParameterDirection)

このメソッドは、指定された名前、データベース型、パラメータ値および方向を使用して、OracleParameterオブジェクトをコレクションに追加します。

宣言
// C#
public OracleParameter Add(string name, OracleDbType dbType, object val,
 ParameterDirection dir);
パラメータ
戻り値

コレクションに追加された、新しく作成されたOracleParameterオブジェクト

// C#
...
OracleParameter prm = new OracleParameter();
prm = cmd.Parameters.Add("paramEmpno", OracleDbType.Decimal, 1234,
   ParameterDirection.Input);

cmd.CommandText = "insert into NumTable(numcol) values(:1)";
cmd.ExecuteNonQuery();
...

関連項目:

Add(string, OracleDbType, int, object, ParameterDirection)

このメソッドは、指定された名前、データベース型、サイズ、パラメータ値および方向を使用して、OracleParameterオブジェクトをコレクションに追加します。

宣言
// C#
public OracleParameter Add(string name, OracleDbType dbType, int size,
   object val, ParameterDirection dir;
パラメータ
戻り値

コレクションに追加された、新しく作成されたOracleParameterオブジェクト

関連項目:

Add(string, OracleDbType, int)

このメソッドは、指定された名前、データベース型およびサイズを使用して、OracleParameterオブジェクトをコレクションに追加します。

宣言
// C#
public OracleParameter Add(string name, OracleDbType dbType, int size);
パラメータ
戻り値

コレクションに追加された、新しく作成されたOracleParameterオブジェクト

// C#
...
OracleParameter prm = new OracleParameter();
prm = cmd.Parameters.Add("param1", OracleDbType.Decimal, 10);
prm.Direction = ParameterDirection.Input;
prm.Value = 1111;

cmd.CommandText = "insert into NumTable(numcol) values(:1)";
cmd.ExecuteNonQuery();
...

関連項目:

Add (string, OracleDbType, int, string)

このメソッドは、指定された名前、データベース型、サイズおよびソース列を使用して、OracleParameterオブジェクトをコレクションに追加します。

宣言
// C#
public OracleParameter Add(string name, OracleDbType dbType, int size,
  string srcColumn);
パラメータ
戻り値

OracleParameter

関連項目:

Add(string, OracleDbType, int, ParameterDirection, bool, byte, byte, string, DataRowVersion, object)

このメソッドは、指定された名前、データベース型、サイズ、方向、NULLインジケータ、精度、位取り、ソース列、ソースのバージョンおよびパラメータ値を使用して、OracleParameterオブジェクトをコレクションに追加します。

宣言
// C#
public OracleParameter Add(string name, OracleDbType dbType, int size,
  ParameterDirection dir, bool isNullable, byte precision,
  byte scale, string srcColumn, DataRowVersion version, object val);
パラメータ
戻り値

コレクションに追加された、新しく作成されたOracleParameterオブジェクト

例外

ArgumentException: 指定されたval型が、ODP.NET型のValueプロパティの型ではありません。

関連項目:

Clear

このメソッドは、コレクションからすべてのOracleParameterオブジェクトを削除します。

宣言
// C#
public void Clear();
実装

IList

// C#
...
OracleParameter [] prm = new OracleParameter[3];

prm[0] = cmd.Parameters.Add("paramEmpno", OracleDbType.Decimal,
   1234, ParameterDirection.Input);
prm[1] = cmd.Parameters.Add("paramEname", OracleDbType.Varchar2,
   "Client", ParameterDirection.Input);
prm[2] = cmd.Parameters.Add("paramDeptNo", OracleDbType.Decimal, 10,
    ParameterDirection.Input);

cmd.CommandText = "insert into emp(empno, ename, deptno) values(:1,:2, :3)";
cmd.ExecuteNonQuery();

// This method removes all the parameters from the parameter collection.
cmd.Parameters.Clear();
...

関連項目:

Contains

Containsは、コレクションに指定されたオブジェクトが存在するかどうかを示します。

オーバーロード一覧:

Contains(object)

このメソッドは、コレクションに指定されたオブジェクトが存在するかどうかを示します。

宣言
// C#
public bool Contains(object obj)
パラメータ
戻り値

指定されたOracleParameterがコレクション内にあるかどうかを示すbool

実装

IList

例外

InvalidCastException: 指定されたobjOracleParameterオブジェクトではありません。

備考

コレクションにOracleParameterオブジェクトが含まれる場合、true、それ以外の場合、falseを返します。

...
prm = cmd.Parameters.Add("param1", OracleDbType.Decimal, 1234,
     ParameterDirection.Input);
if (cmd.Parameters.Contains((Object)prm))
// This method removes a particular parameter from the parameter collection.
cmd.Parameters.Remove((Object) prm);
...

関連項目:

Contains(string)

このメソッドは、指定された文字列を使用して、コレクションにOracleParameterオブジェクトが存在するかどうかを示します。

宣言
// C#
public bool Contains(string name);
パラメータ
戻り値

指定されたパラメータ名を持つOracleParameterオブジェクトがコレクションに含まれる場合、true、それ以外の場合、falseを返します。

実装

IDataParameterCollection

...
prm = cmd.Parameters.Add("param1", OracleDbType.Decimal, 1234, +
     ParameterDirection.Input);
if (cmd.Parameters.Contains((Object)prm))
// This method removes a particular parameter from the parameter collection.
cmd.Parameters.Remove((Object) prm);
...

関連項目:

CopyTo

このメソッドは、指定された配列の指定されたインデックスを開始位置として、コレクションからOracleParameterオブジェクトをコピーします。

宣言
// C#
public void CopyTo(Array array, int index);
パラメータ
実装

ICollection

関連項目:

IndexOf

IndexOfは、コレクション内のOracleParameterオブジェクトのインデックスを返します。

オーバーロード一覧:

IndexOf(object)

このメソッドは、コレクション内のOracleParameterオブジェクトのインデックスを返します。

宣言
// C#
public int IndexOf(object obj);
パラメータ
戻り値

コレクション内のOracleParameterオブジェクトのインデックスを返します。

実装

IList

例外

InvalidCastException: 指定されたobjOracleParameterオブジェクトにキャストできません。

備考

コレクション内の指定されたOracleParameterオブジェクトのインデックスを返します。

関連項目:

IndexOf(String)

このメソッドは、コレクション内の指定された名前を持つOracleParameterオブジェクトのインデックスを返します。

宣言
// C#
public int IndexOf(String name);
パラメータ
戻り値

コレクション内の指定されたOracleParameterのインデックスを返します。

実装

IDataParameterCollection

関連項目:

Insert

このメソッドは、指定されたOracleParameterオブジェクトを、コレクションの指定されたインデックス位置に挿入します。

宣言
// C#
public void Insert(int index, object obj);
パラメータ
実装

IList

備考

InvalidCastExceptionは、指定されたobjOracleParameterオブジェクトにキャストできない場合にスローされます。

関連項目:

Remove

このメソッドは、コレクションから指定されたOracleParameterを削除します。

宣言
// C#
public void Remove(object obj);
パラメータ
実装

IList

例外

InvalidCastException: 指定されたobjOracleParameterオブジェクトにキャストできません。

...
prm = cmd.Parameters.Add("param1", OracleDbType.Decimal, 1234,
     ParameterDirection.Input);
if (cmd.Parameters.Contains((Object)prm))
// This method removes a particular parameter from the parameter collection.
cmd.Parameters.Remove((Object) prm);
...

関連項目:

RemoveAt

RemoveAtは、位置によってコレクションからOracleParameterオブジェクトを削除します。

オーバーロード一覧:

RemoveAt(int)

このメソッドは、指定されたインデックスによって指定されたインデックス位置にあるOracleParameterオブジェクトをコレクションから削除します。

宣言
// C#
public void RemoveAt(int index);
パラメータ
実装

IList

関連項目:

RemoveAt(String)

このメソッドは、指定された名前によって指定されたOracleParameterオブジェクトをコレクションから削除します。

宣言
// C#
public void RemoveAt(String name);
パラメータ
実装

IDataParameterCollection

関連項目:


Go to previous page Go to beginning of chapter Go to next page
Oracle
Copyright © 2002, 2003 Oracle Corporation.

All Rights Reserved.
Go To Table Of Contents
目次
Go To Index
索引