GetValue(OracleConnection, IntPtr, string, out object)

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

宣言

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

パラメータ

con

OracleConnectionインスタンス。
pUdt

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

取得される大/小文字を区別する属性の名前。Oracleコレクションを表すカスタム・タイプからコレクション要素を取得する場合に、NULLを指定する必要があります。
statusArray - OracleUdtStatus配列であり、取得されたコレクション要素に対してNULLステータスを戻します。

戻り値

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

例外

ArgumentException - 指定された名前は無効な属性名です。

備考

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