OracleDataReader.GetSchemaTable メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

OracleDataReader.GetSchemaTable メソッド

OracleDataReader の列メタデータを記述する DataTable を返します。

名前空間: System.Data.OracleClient
アセンブリ: System.Data.OracleClient (system.data.oracleclient.dll 内)
構文

Visual Basic (宣言)

Public Overrides Function
 GetSchemaTable As DataTable

Visual Basic (使用法)

Dim instance As OracleDataReader
Dim returnValue As DataTable

returnValue = instance.GetSchemaTable

public override DataTable GetSchemaTable ()

C++

public:
virtual DataTable^ GetSchemaTable () override

public DataTable GetSchemaTable ()

JScript

public override function GetSchemaTable ()
 : DataTable

戻り値
列メタデータを説明する DataTable。

解説

GetSchemaTable メソッドは、各列のメタデータを次の順序で返します。

DataReader 列	説明
ColumnName	列名。列名は一意でない場合もあります。列名が判断できない場合は、null 値が返されます。この名前は、現在のビュー内またはコマンドテキスト内の列に対して指定された最新の名前を常に反映しています。
ColumnOrdinal	列の序数。行のブックマーク列 (ある場合) は 0 になります。その他の列は、1 から順に番号が付けられます。この列には null 値を含めることはできません。
ColumnSize	列の値に許容される最大長。固定長データ型を使用する列では、そのデータ型のサイズです。
NumericPrecision	DbType が数値データ型の場合は、列の最大精度になります。精度は、列の定義によって決まります。
NumericScale	DbType が数値データ型の場合、小数点の右側の桁数。
DataType	DbType の共通言語ランタイムの型に割り当てます。
IsLong	長いデータが格納された BLOB (Binary Long Object) が列に格納されている場合、true。
AllowDBNull	コンシューマが列を null 値に設定できる場合は true。それ以外の場合は false。列を null 値に設定できない場合でも、null 値が含まれている可能性があります。
IsUnique	true の場合は、この列では、ベーステーブル (BaseTableName で返されるテーブル) 内で行に重複する値を格納できないことを示します。列自体がキーを構成している場合や、その列だけに適用される UNIQUE 型の制約がある場合は、IsUnique は必ず true になります。false : 列はベーステーブル内に重複する値を格納できます。この列の既定値は false です。
IsKey	true の場合は、列が、行セット内の行を一意に識別するために組み合わされる、列のセットの 1 つであることを示します。IsKey が true に設定された列のセットは、行セット内の行を一意に識別する必要があります。この列のセットが列の最小セットである必要はありません。この列のセットは、ベーステーブルの主キー、UNIQUE 制約、または一意のインデックスから生成されることもあります。false の場合は、列が、行を一意に識別する必要がないことを示します。
BaseTableName	列を格納している、データストア内のテーブルまたはビューの名前。ベーステーブル名を判断できない場合は null 値。この列の既定値は null 値です。
BaseColumnName	データストア内での列名。別名が使用された場合は、ColumnName 列に返される列名とは異なることがあります。基本列名を判断できない場合や、取得された行セット列がデータストア内の列と一致しない場合は、null 値。この列の既定値は null 値です。
BaseSchemaName	列を格納している、データストア内のスキーマの名前。基本スキーマ名を判断できない場合は null 値。この列の既定値は null 値です。

結果セットの各列ごとに行が返されます。

メモ
メタデータの列が正しい情報を確実に返すようにするには、behavior パラメータを KeyInfo に設定して ExecuteReader を呼び出す必要があります。それ以外の場合、スキーマテーブルのいくつかの列は、既定のデータ、null、または正しくないデータを返します。