Data.DB.TDataSet.FieldByName
Delphi
function FieldByName(const FieldName: string): TField;
C++
TField* __fastcall FieldByName(const System::UnicodeString FieldName);
Inhaltsverzeichnis
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | Data.DB.pas Data.DB.hpp |
Data.DB | TDataSet |
Beschreibung
Sucht ein Feld anhand seines Namens.
Mit FieldByName können Sie Informationen zu einem Feld über dessen Namen abrufen. Dieser Name wird im Parameter FieldName übergeben. Die Methode FieldByName gibt die TField-Komponente des gesuchten Feldes zurück. Ist das angegebene Feld nicht vorhanden, wird eine EDatabaseError-Exception ausgelöst.
FieldName kann der Name eines einfachen Feldes, der qualifizierte Name eines Unterfeldes in einem Objektfeld oder der Name eines Aggregatfeldes sein. Aufgrund dieser Flexibilität ist FieldByName in vielen Situationen besser geeignet als die Eigenschaft Fields oder AggFields.
In einer Anwendung kann direkt auf bestimmte Eigenschaften und Methoden des von FieldByName zurückgegebenen Feldes zugegriffen werden. So kann beispielsweise mit folgender Anweisung ermittelt werden, ob ein bestimmtes Feld ein berechnetes Feld ist:
Delphi:
if Customers.FieldByName('FullName').Calculated then
// …
C++:
if (Customers->FieldByName("FullName")->Calculated)
// …
FieldByName ist insbesondere während des Entwurfs hilfreich, wenn Sie keinen Zugriff auf die zugrunde liegende Tabelle haben und deshalb keine persistenten Feldkomponenten verwenden können.
Tipp: Um auf den Wert eines bestimmten Feldes zuzugreifen, rufen Sie anstelle von FieldByName die Standard-Datenmengenmethode FieldValues auf.
Siehe auch
- Data.DB.TDataSet.FieldByNumber
- Data.DB.TDataSet.Fields
- Data.DB.TDataSet.FindField
- Data.DB.TDataSet.FieldValues
- Data.DB.TDataSet.AggFields
- Data.DB.TDataSet.ObjectView