Data.DB.TDataSet.FieldByName

• 親: TDataSet

Delphi

function FieldByName(const FieldName: string): TField;

C++

TField* __fastcall FieldByName(const System::UnicodeString FieldName);

プロパティ

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

説明

名前に基づいてフィールドを検索します。

FieldByName を呼び出すと、渡された名前のフィールドのフィールド情報を取得することができます。 FieldName は、既存のフィールドの名前です。 FieldByName は、指定されたフィールドを表す TField コンポーネントを返します。 指定されたフィールドが存在しない場合、FieldByName は EDatabaseError 例外を発生させます。

FieldName はシンプルなフィールド名、親のフィールド名によって限定されたオブジェクト フィールドのサブフィールド名、集計フィールドの名前などにすることができます。 この柔軟性のため、Fields プロパティや AggFields プロパティより、FieldByName の方がしばしば好まれます。

アプリケーションは、FieldByName によって返されるフィールドの特定のプロパティやメソッドに、直接アクセスすることができます。 たとえば、次の文では、特定のフィールドが計算フィールドかどうかを決定します：

Delphi：

if Customers.FieldByName('FullName').Calculated then
  // …

C++：

if (Customers->FieldByName("FullName")->Calculated)
  // …

FieldByName はデータベース アプリケーションを作成する開発者にとって特に設計時に便利ですが、基とするテーブルへのアクセスができず、このため、永続フィールド コンポーネントを使用することができません。

ヒント： 特定のフィールドに対して値の取得、設定を行うには、FieldByName に代わりに、デフォルト データセット メソッド FieldValues を呼び出します。

関連項目

• Data.DB.TDataSet.FieldByNumber
• Data.DB.TDataSet.Fields
• Data.DB.TDataSet.FindField
• Data.DB.TDataSet.FieldValues
• Data.DB.TDataSet.AggFields
• Data.DB.TDataSet.ObjectView

• 範囲の指定

• データセットの FieldByName メソッドでフィールド値にアクセスする

コード サンプル

• CreateBlobStream (C++)
• DBBitType (Delphi)
• FishFacts (Delphi)
• TDataSetBeforeInsert (Delphi)