16.7.2.5 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ステータスが指定されて移入されます。