RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
TSQLTimeStampField.Create Constructor

Creates and initializes a TSQLTimeStampField object.

Pascal
constructor Create(AOwner: TComponent); override;
C++
virtual __fastcall TSQLTimeStampField(TComponent * AOwner);

Most applications do not explicitly create instances of TSQLTimeStampField. Instead, the field components are created automatically, as persistent field components defined in the Fields editor at design time or as dynamic field components created automatically by the dataset. 

Create sets the DataType property to ftTimeStamp. The AOwner parameter specifies the component, typically a dataset, that becomes the new field's Owner. The Owner is responsible for freeing the component. 

In the rare cases when you must create a persistent field component at runtime, call Create to create and initialize an instance of TSQLTimeStampField. After instantiating a TSQLTimeStampField, associate it with a specific field by setting its FieldName property to the name of the field. Give the TSQLTimeStampField a unique identifier in the Name property. Establish where the field appears in the collection of fields by providing an ordinal number in the Index property. Associate the TSQLTimeStampField with a dataset component by setting its DataSet property to the name of the dataset component. Optionally set the DisplayFormat property to the desired date and time format. 

The example below creates a TSQLTimeStampField object for a field named CheckOut accessed through a TSQLDataSet named SQLDataSet1.

var
  T: TSQLTimeStampField;
begin
  SQLDataSet1.Close;
  T := TSQLTimeStampField.Create(SQLDataSet1);
  T.FieldName := 'CheckOut';
  T.Name := SQLDataSet1.Name + T.FieldName;
  T.Index := SQLDataSet1.FieldCount;
  T.DataSet := SQLDataSet1;
  T.DisplayFormat := 'mm/dd/yyyy hh:nn:ss ampm';
  SQLDataSet1.FieldDefs.UpDate;
  SQLDataSet1.Open;
end;

 

SQLDataSet1->Close();
TSQLTimeStampField *T = new TSQLTimeStampField(SQLDataSet1);
T->FieldName = "CheckOut";
T->Name = SQLDataSet1->Name + T->FieldName;
T->Index = SQLDataSet1->FieldCount;
T->DataSet = SQLDataSet1;
T->DisplayFormat = "mm//dd//yyyy hh:nn:ss ampm";
SQLDataSet1->FieldDefs->UpDate();
SQLDataSet1->Open();

 

Copyright(C) 2008 CodeGear(TM). All Rights Reserved.
What do you think about this topic? Send feedback!