Data.DB.TField

• 親: Data.DB
• メソッド
• プロパティ
• イベント
• フィールド

Delphi

TField = class(TComponent)

C++

class PASCALIMPLEMENTATION TField : public System::Classes::TComponent

プロパティ

種類	可視性	ソース	ユニット	親
class	public	Data.DB.pas Data.DB.hpp	Data.DB	Data.DB

説明

TField は、すべてのフィールド コンポーネントの共通の祖先です。

TField は、すべてのフィールド コンポーネントに共通する基本的な動作をカプセル化しています。 次の用途に使用されるプロパティ、イベント、メソッドなどを定義しています：

• データセット内のフィールドの値の変更

• あるデータ型から別のものへの、フィールドの値の変換

• フィールドにユーザーが入力してデータの検証

• フィールドのデータが、表示時または編集時にどのように表示されるかの定義

• データセットの OnCalcFields イベント内で記述されたコードでの、フィールドの値の計算

• 他のデータセットからのフィールド値の検索

TField のインスタンスは作成しないでください。 TField の下位オブジェクトは、データセットが有効になるたびに、自動的に作成されます。これらの下位オブジェクトは、動的にも(デフォルト）永続的にもすることができます。動的フィールド コンポーネントは、データセットが開いたときに、基礎としているメタデータ内の列を反映します。永続フィールド コンポーネントは、設計時にフィールド エディタを使用して作成されるもので、データセット内のフィールド、それらのプロパティ、それらの順番などを指定します。

永続化フィールド コンポーネントを作成すると、たとえ、基になるデータベースの物理構造に変更があったとしても、アプリケーションの実行では、毎回同じ列が同じ順番で表示され、使用できることが保証されます。永続化フィールド コンポーネントがベースとしている列が、削除または変更された場合、IDE は、存在しない列や該当しないデータのためにデータセットを開くのではなく、例外を生成します。その場合、存在しないフィールドに対応するフィールド コンポーネントは、フィールド エディタ を使用して削除してください。

TField オブジェクトの値の読み込み

DataType プロパティを使用すると、TField オブジェクトがどの値の型かを判別することができます。

As が前についたプロパティのいずれかを使用すると、適切な型を使用した TField オブジェクトの値を取得することができます：

• AsAnsiString
• AsBCD
• AsBoolean
• AsBytes
• AsCurrency
• AsDateTime
• AsExtended
• AsFloat
• AsInteger
• AsLargeInt
• AsLongWord
• AsSingle
• AsSQLTimeStamp
• AsSQLTimeStampOffset
• AsString
• AsVariant
• AsWideString

TField オブジェクトの型に合っていないプロパティを読み込んだ場合、例外が発生します。

TField オブジェクトが null 値を持っている場合、IsNull は True となります。null 値を持つ TField オブジェクトの値を読み込んだ際、それに相当する型のデフォルト値を取得します。たとえば、AsInteger は null 値に対しては 0 となります。

サブクラス

データセット内のフィールドは常に、次の TField 下位クラスのいずれかとして処理されます：

下位クラス	説明
TADTField	TADTField オブジェクトは，データセット内の ADT（抽象データ型）項目を表します。
TDateField	TDateField は、データセット内の日付フィールドを表します。
TReferenceField	TReferenceField は，データセット内の REF 項目を表します。
TAggregateField	TAggregate フィールドは、クライアント データセットに保持された集計を表します。
TDateTimeField	TDateTimeField は、データセット内の日時フィールドを表します。
TSmallintField	データセット内の符号付き 16 ビット整数フィールドを表します。
TArrayField	TArrayField は，データセット内の配列項目を表します。
TFloatField	TFloatField は、データセット内の浮動小数点値を格納しているフィールドを表します。
TSQLTimeStampField	TSQLTimeStampField は，dbExpress データセット内の日付時刻型項目を表します。
TAutoIncField	TAutoIncField は、データセット内において自動インクリメントされる、永続フィールド オブジェクトです。
TFMTBCDField	TFMTBCDField は，データセット内の 2 進化 10 進数（BCD）項目を表します。
TStringField	TStringField は，データセット内の文字列項目を表します。
TBCDField	TBCDField は、データセット内の BCD（2進化10進数）を表します。
TGraphicField	TGraphicField はデータセット内のグラフィック型項目を表します。
TTimeField	TTimeField は，データセット内の時刻項目を表します。
TBinaryField	TBinaryField は、データセット内の型のないバイナリ フィールドを表します。
TGuidField	TGuidField は，データセットの GUID 項目を表します。
TVarBytesField	TVarBytesField は，データセット内の型なし可変長バイナリ項目を表します。
TBlobField	TBlobField は、BLOB（Binary Large Object）への参照を保有する、データセット内の 1 つのフィールドを表します。
TIDispatchField	TIDispatchField は，データセットの IDispatch 項目を表します。
TVariantField	TVariantField は，データセット内のバリアント項目を表します。
TBooleanField	TBooleanField は、Boolean 値を保持するフィールドを表します。
TIntegerField	データセット内の符号付き 32 ビット整数フィールドを表します。
TWideStringField	TWideStringField は、データセット内の長い文字列フィールドを表します。
TBytesField	TBytesField は、データセット内のバイト フィールドを表します。
TInterfaceField	TInterfaceField は，データセットのインターフェース項目を表します。
TWordField	データセット内の符号なし 16 ビット整数フィールドを表します。
TCurrencyField	TCurrencyField は、データセット内の通貨値を格納しているフィールドを表します。
TLargeintField	TLargeintField は，データセット内の Largeint 項目を表します。
TDataSetField	TDataSetField は，ネストされたデータセットへのアクセスを提供します。
TMemoField	TMemoField は、データセット内のメモ フィールドを表します。

関連項目

• Data.DB.TDataSet

• Data.DB.TFieldDef

• Data.DB.TFieldDefs

• データセットについて：概要

• 配列フィールドを操作する

• 実行時のフィールド コンポーネント メソッドでの作業

• 動的フィールド コンポーネント

• フィールド コンポーネントでの作業 - 概要