Data.DB.TFields.FieldByName

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function FieldByName(const FieldName: string): TField;

C++

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

Propriétés

Type Visibilité  Source Unité  Parent
function public
Data.DB.pas
Data.DB.hpp
Data.DB TFields

Description

Renvoie le champ du nom spécifié.

Appelez FieldByName pour extraire des informations champs pour un champ lorsque seul le nom du champ est connu. FieldName est le nom d'un champ existant. FieldByName renvoie le composant TField pour le champ spécifié. Si le champ ne peut pas être trouvé, une exception est déclenchée.

Quand le tableau Fields contient des champs ADT, vous pouvez utiliser FieldByName pour accéder aux sous-champs de ces champs ADT. Pour accéder aux sous-champs, attribuez à FieldName le nom du sous-champ qualifié par le nom du champ ADT, comme suit :



CityEdit.Text := Customer.FieldByName('Address.City').AsString;



CityEdit->Text = Customer->FieldByName("Address.City")->AsString;



FieldByName est particulièrement utile quand vous ne pouvez pas accéder à la table sous-jacente et utiliser des composants champ persistants.

Remarque :  FieldByName diffère de la méthode FindField seulement quand le champ nommé n'est pas dans la liste. Quand le champ est introuvable, FieldByName déclenche une exception, tandis que FindField renvoie nil (Delphi) ou NULL (C++).

Voir aussi