GetValue(OracleConnection, IntPtr, int, out object)

このメソッドは、指定Oracleオブジェクトの指定コレクション属性の要素または指定Oracleコレクションの要素のいずれかを戻します。

宣言

// C#
public static object GetValue(OracleConnection con, IntPtr pUdt, int attrIndex, 
   out object statusArray);

パラメータ

con

OracleConnectionインスタンス。
pUdt

Oracle UDTへのOPAQUE型のポインタ。
attrIndex

取得される属性のゼロベースの索引。Oracleコレクションを表すカスタム・タイプからコレクション要素を取得する場合、0を指定します。
statusArray

OracleUdtStatus配列で、取得されたコレクション要素に対してNULLステータスを戻します。

戻り値

戻された属性またはコレクション要素を表すオブジェクト。

例外

ArgumentOutOfRangeException - 指定された索引は無効な属性索引です。

備考

IOracleCustomType.ToCustomObjectメソッドは、OracleUdt.GetValueメソッドを呼び出し、conおよびpUdtパラメータを渡します。OracleUdt.GetValueメソッドは次のタイプのオブジェクトを戻します。

Oracleオブジェクト型

カスタム・タイプがOracleオブジェクト型を表す場合、指定された属性索引の戻されるタイプは、カスタム・クラスまたは構造体のメンバーのタイプであり、OracleObjectMappingAttributeオブジェクトを使用して属性にマップされます。
Oracleコレクション型

カスタム・タイプがOracleコレクション型を表す場合、戻されるタイプは、OracleArrayMappingAttributeオブジェクトが適用されたカスタム・クラスまたは構造体のメンバーのタイプです。

NULL属性値の場合、タイプの適切なNULL表現を戻します。たとえば、カスタム・タイプおよびプロバイダ固有のタイプを表す属性の場合、タイプの静的Nullプロパティを戻します。Nullableタイプを表す属性の場合、たとえばSystem.StringおよびSystem.ArrayタイプにはNULLを戻し、Int32およびDateTimeのような他の残りのビルトイン・タイプには、DBNull.Valueを戻します。

戻されたコレクションがNULLでない場合、出力statusArrayパラメータはコレクション要素ごとにNULLステータスが指定されて移入されます。