API:Data.DB.TStringField

Delphi

TStringField = class(TField)

C++

class PASCALIMPLEMENTATION TStringField : public TField

Sommaire

1 Propriétés
2 Description

Propriétés

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

Description

TField est l'ancêtre commun à tous les composants champ.

Data.DB.TStringField hérite de Data.DB.TField. Tout le contenu en-dessous de cette ligne se réfère à Data.DB.TField.

TField est l'ancêtre commun à tous les composants champ.

TField encapsule les comportements fondamentaux communs à tous les composants champ. Il introduit les propriétés, méthodes et événements utilisés pour :

Modifier la valeur d'un champ d'un ensemble de données.

Convertir la valeur d'un champ d'un type de données dans un autre.

Valider les données au fur et à mesure que l'utilisateur les saisit dans un champ.

Définir comment les données du champ apparaissent quand elles sont affichées ou modifiées.

Calculer la valeur d'un champ à partir du code écrit dans l'événement OnCalcFields de l'ensemble de données.

Rechercher la valeur du champ dans un autre ensemble de données.

Ne créez pas d'instances de TField. Les descendants de TField sont automatiquement créés à chaque fois qu'un ensemble de données est activé. Ces descendants peuvent être dynamiques (par défaut) ou persistants. Les composants champ dynamiques reflètent les colonnes des métadonnées sous-jacentes au moment de l'ouverture d'un ensemble de données. Les composants champ persistants sont créés à la conception en utilisant l'éditeur de champs pour choisir les champs de l'ensemble de données, leurs propriétés et leur ordre.

La création de composants champ persistants permet d'être certain qu'à chaque fois qu'une application est exécutée, elle utilise et affiche les mêmes colonnes dans le même ordre quand bien même la structure des bases de données sous-jacentes a changé. Si une colonne sur laquelle est basé un composant champ persistant a été supprimée ou modifiée, l'EDI génère une exception au lieu d'ouvrir l'ensemble de données avec une colonne inexistante ou des données non concordantes. Si cela se produit, supprimez le composant champ associé au champ inexistant en utilisant l'éditeur de champs.

Lecture de la valeur d'un objet TField

Utilisez la propriété DataType pour savoir le type de valeur contenu par un TField.

Utilisez l'une des propriétés préfixées avec As pour obtenir la valeur de l'objet TField en utilisant un type approprié :

Si vous lisez une propriété qui n'est pas adaptée au type de votre objet TField, une exception est déclenchée.

Si votre objet TField contient une valeur null, IsNull vaut True. Quand vous lisez la valeur d'un objet TField qui contient une valeur null, vous obtenez la valeur par défaut du type correspondant ; par exemple, AsInteger vaut 0 pour une valeur null.

Sous-classes

Un champ d'un ensemble de données est toujours traité comme une des classes ci-dessous descendant de TField :

Classe descendante	Description
TADTField	Un objet TADTField représente un champ ADT (Abstract Data Type) d'un ensemble de données.
TDateField	TDateField représente un champ date d'un ensemble de données.
TReferenceField	TReferenceField représente un champ REF d'un ensemble de données.
TAggregateField	TAggregateField représente un agrégat maintenu d'un ensemble de données client.
TDateTimeField	TDateTimeField représente un champ date-heure dans un ensemble de données.
TSmallintField	Représente un champ d'un ensemble de données contenant un entier signé sur 16 bits.
TArrayField	TArrayField représente un champ tableau d'un ensemble de données.
TFloatField	TFloatField représente un champ d'un ensemble de données contenant des valeurs à virgule flottante.
TSQLTimeStampField	TSQLTimeStampField représente un champ date-heure dans un ensemble de données DBExpress.
TAutoIncField	TAutoIncField est un objet champ persistant pour un champ auto-incrémenté d'un ensemble de données.
TFMTBCDField	TFMTBCDField représente un champ décimal codé binaire (DCB) d'un ensemble de données.
TStringField	TStringField représente un champ chaîne d'un ensemble de données.
TBCDField	TBCDField représente un champ décimal codé binaire (DCB) d'un ensemble de données.
TGraphicField	TGraphicField représente un champ graphique d'un ensemble de données.
TTimeField	TTimeField représente un champ heure d'un ensemble de données.
TBinaryField	TBinaryField représente un champ binaire sans type d'un ensemble de données.
TGuidField	TGuidField représente un champ guid d'un ensemble de données.
TVarBytesField	TVarBytesField représente un champ binaire non typé de largeur variable d'un ensemble de données.
TBlobField	TBlobField représente un champ d'un ensemble de données contenant une référence à un objet binaire volumineux (BLOB).
TIDispatchField	TIDispatchField représente un champ IDispatch dans un ensemble de données.
TVariantField	TVariantField représente un champ variant d'un ensemble de données.
TBooleanField	TBooleanField représente un champ contenant une valeur booléenne.
TIntegerField	Représente un champ d'un ensemble de données contenant une valeur entière signée sur 32 bits.
TWideStringField	TWideStringField représente un champ chaîne large dans un ensemble de données.
TBytesField	TBytesField représente un champ d'octets d'un ensemble de données.
TInterfaceField	TInterfaceField représente un champ interface d'un ensemble de données.
TWordField	Représente un champ d'un ensemble de données contenant un entier non signé sur 16 bits.
TCurrencyField	TCurrencyField représente un champ d'un ensemble de données contenant des valeurs monétaires.
TLargeintField	Un objet TLargeintField représente un champ entier long dans un ensemble de données.
TDataSetField	TDataSetField fournit un accès aux ensembles de données imbriqués.
TMemoField	TMemoField représente un champ mémo d'un ensemble de données.