TDataSet
Conheça a documentação do TDataset (Propriedades e Métodos) e TFieldDefs (Propriedades e Métodos )
Propriedades do TDataSet
Propriedade | Descrição |
Active | Propriedade que indica se o dataset está ativo (aberto) ou não. |
AutoCalcFields | Propriedade que indica se o dataset chama o evento que calcula os campos calculados automaticamente. |
BOF | Propriedade que indica o início da lista de dados (primeiro registro). |
Bookmark | Propriedade que retorna um marcador de registro na forma de string. É do tipoTBookmarkStr. |
CanModify | Propriedade que indica se os dados do dataset podem ser modificados ou não. |
DataSource | Propriedade que carrega em si o datasource associado ao dataset. Essa propriedade é negligenciada na WOL. Os objetos acessam os dados diretamente do banco de dados. É do tipo TDataSource. |
DefaultFields | Propriedade que indica que o dataset apresenta os campos defaults. |
EOF | Propriedade que indica se a posição corrente é o final da lista de dados (último registro). |
FieldCount | Propriedade que indica a quantidade de campos do dataset. |
FieldDefs | Propriedade que carrega a lista de definições de campos do dataset. É do tipoTFieldDefs. |
Fields[Index:Integer] | Propriedade que carrega o campo de índice especificado. É do tipo TField. |
FieldValues[FieldName:string] | Propriedade que carrega o valor do campo de nome indicado. É do tipoVariant. |
Filter | Propriedade que carrega a informação de seleção de registro. |
Filtered | Propriedade que indica se o dataset está sendo filtrado ou não. Ver Filter. |
FilterOptions | Propriedade que indica as opções de filtragem (seleção de registros) dodataset. É do tipo TFilterOptions. |
Found | Propriedade que indica que a última busca foi bem sucedida ou não. |
Modified | Propriedade que indica se o dataset foi modificado ou não. |
RecNo | Propriedade que indica o registro corrente apontado pelo ponteiro do dataset. |
RecordCount | Propriedade que retorna a quantidade registros do dataset. |
RecordSize | Propriedade que retorna o tamanho de cada registro do dataset. |
State | Propriedade que indica o estado de edição do dataset. É do tipoTDataSetState. |
Métodos e Eventos Públicos
— function ActiveBuffer:PChar; |
Método usado para recuperar o buffer de dados correntemente ativo. |
— procedure Append; |
Método usado para apendar (inserir ao final) um registro vazio na lista do dataset. |
— procedure AppendRecord(const Values: array of const); |
Método usado para apendar um registro contendo um conjunto de dados (um para cada campo) na lista dodataset. |
— function BookMarkValid(aBookmark:TBookmark):Boolean; virtual; |
Método usado para averiguar a validade de um marcador de registro. |
— procedure Cancel; virtual; |
Método usado para cancelar uma operação. Em geral, a última operação. |
— procedure CheckBrowseMode; |
Método usado internamente para verificar o modo de edição e gravar informações pendentes. |
— procedure ClearFields; |
Método usado internamente para limpar as informações dos campos. |
— procedure Close; |
Método usado para fechar o dataset. |
— function CompareBookmarks(Bookmark1, Bookmark2:TBookmark):Integer; virtual; |
Método usado internamente para comparar dois marcadores de registros. |
— function ControlsDisabled: Boolean; |
Método usado para inferir se os objetos agregados ao dataset estão desabilitados. |
— constructor Create(AOwner: TWOLRoot); override; |
Método usado para criar o objeto. |
— procedure CursorPosChanged; |
Método usado internamente para informar ao objeto que o ponteiro de registro mudou de posição. |
— procedure Delete; |
Método usado para apagar o registro corrente. |
— destructor Destroy; override; |
Método usado para destruir o objeto. |
— procedure DisableControls; |
Método usado para desabilitar componentes que estejam agregados ao dataset como um datasource. |
— procedure Edit; |
— Método usado para por o dataset em estado de edição. |
— procedure EnableControls; |
Método usado para habilitar os objetos agregados ao dataset como um datasource. |
— function FieldByName(const FieldName:string):TField; |
Método usado para retornar um campo pelo nome que o campo da tabela tem. Muito usado para manipular dados em uma tabela juntamente com as propriedades que retornam valores dos campos: Tabela.FieldByName(‘NomeCampo’).AsString:=’Carlos’;. |
— function FindField(const FieldName:string):TField; |
Método usado para procurar um campo pelo nome. Se o campo não existir, retorna nil. |
— function FindFirst:Boolean; |
Método usado para veriricar se uma informação foi encontrada numa primeira posição. |
— function FindLast:Boolean; |
Método usado para veriricar se uma informação foi encontrada na posição mais posterior à corrente. |
— function FindNext:Boolean |
Método usado para verificar se uma informação foi encontrada numa posição posterior à corrente. |
— function FindPrior:Boolean; |
Método usado para verificar se uma informação foi encontrada numa posição anterior à corrente. |
— procedure First; |
Método usado para mover o ponteiro de registro para a primeira posição. |
— procedure FreeBookmark(aBookmark:TBookmark); virtual; |
Método usado para liberar da memória um marcador de registro. Deve ser chamado sempre que GetBookMark o for. |
— function GetBookmark:TBookmark; virtual; |
Método usado para recuperar o marcador de registro corrente. |
— function GetCurrentRecord(Buffer:PChar):Boolean; virtual; |
Método usado para recuperar em um buffer o registro corrente. |
— procedure GetFieldList(List:TList; const FieldNames:string); |
Método usado para recuperar uma lista contendo os campos indicados. |
— procedure GetFieldNames(List:TStrings); |
Método usado para recuperar uma lista de nomes dos campos do dataset. |
— procedure GotoBookmark(aBookmark:TBookmark); |
Método usado para se mover do registro corrente para o registro que foi marcado com GetBookMark. |
— procedure Insert; |
Método usado para inserir um registro em branco na posição corrente do ponteiro de registro. |
— procedure InsertRecord(const Values:array of const); |
Método usado para inserir um registro contendo os valores indicados na posição corrente do ponteiro de registro. |
— function IsEmpty:Boolean; |
Método usado para retornar se um dataset está vazio ou não. |
— function IsLinkedTo(aDataSource:TDataSource):Boolean; |
Método usado para averiguar se um datasource está ligado ao dataset. |
— procedure Last; |
Método usado para mover o ponteiro de registro para a última posição. |
— function Locate(const KeyFields:string; const KeyValues:Variant; Options:TLocateOptions):Boolean; virtual; |
Método usado para localizar um registro de acordo com os valores passados para comparação. |
— function Lookup(const KeyFields:string; const KeyValues:Variant; const ResultFields:string):Variant; virtual; |
Método usado para localizar valores dos campos especificados dentro da lista de dados do dataset. |
— function MoveBy(Distance: Integer): Integer; |
Método usado para mover o ponteiro de registro em uma determinada quantidade de registros. Valores positivos indicam que o movimento será em direção ao final. Negativos, ao início. |
— procedure Next; |
Método usado para mover o ponteiro de registro para a próxima posição relativa à corrente. |
— procedure Open; |
Método usado para abrir o dataset. |
— procedure Post; virtual; |
Método usado para gravar as informações contidas no registro corrente na lista do dataset. |
— procedure Prior; |
Método usado para mover o ponteiro de registro para uma posição anterior à atual. |
— procedure Refresh; |
Método usado para atualizar os dados do dataset. |
— procedure Resync(Mode:TResyncMode); virtual; |
Método usado para ressincronizar o ponteiro de registro lógico com o ponteiro de registro físico. |
— procedure SetFields(const Values: array of const); |
Método usado para copiar os valores passados para os valores dos campos do dataset. |
— procedure Translate(Src, Dest: PChar; ToOem: Boolean); virtual; |
Método usado para traduzir um conjunto de dados antes de gravá-los de acordo com os caracteres que são usados. |
— procedure UpdateCursorPos; |
Método usado para atualizar a posição do ponteiro de registro. |
— procedure UpdateRecord; |
Método usado para atualizar o registro corrente. |
— AfterCancel:TDataSetNotifyEvent |
Evento disparando quando uma operação é cancelada. |
— AfterClose:TDataSetNotifyEvent |
Evento disparando depois que o dataset é fechado. |
— AfterDelete:TDataSetNotifyEvent |
Evento disparando depois que um registro é apagado. |
— AfterEdit:TDataSetNotifyEvent |
Evento disparando depois que um registro é editado. |
— AfterInsert:TDataSetNotifyEvent |
Evento disparando depois que um registro é inserido. |
— AfterOpen:TDataSetNotifyEvent |
Evento disparando depois que o dataset é aberto. |
— AfterPost:TDataSetNotifyEvent |
Evento disparando depois que os dados são gravados. |
— AfterScroll:TDataSetNotifyEvent |
Evento disparando depois que o ponteiro do dataset muda de posição. |
— BeforeCancel:TDataSetNotifyEvent |
Evento disparando antes que uma opção seja cancelada. |
— BeforeClose:TDataSetNotifyEvent |
Evento disparando antes que o dataset seja fechado. |
— BeforeDelete:TDataSetNotifyEvent |
Evento disparando antes que um registro seja apagado. |
— BeforeEdit:TDataSetNotifyEvent |
Evento disparando antes que um registro seja editado. |
— BeforeInsert:TDataSetNotifyEvent |
Evento disparando antes que um registro seja inserido. |
— BeforeOpen:TDataSetNotifyEvent |
Evento disparando antes que o dataset seja aberto. |
— BeforePost:TDataSetNotifyEvent |
Evento disparando antes que um registro seja gravado. |
— BeforeScroll:TDataSetNotifyEvent |
Evento disparando antes que o ponteiro de registro mude a posição. |
— OnCalcFields:TDataSetNotifyEvent |
Evento disparando quando é necessário o cálculo de campos calculados. |
— OnDeleteError:TDataSetErrorEvent |
Evento disparando quando ocorre um erro durante a tentativa de apagar o registro corrente. |
— OnEditError:TDataSetErrorEvent |
Evento disparando quando ocorre um erro durante a edição de um registro. |
— OnFilterRecord:TFilterRecordEvent |
Evento disparando quando um registro está sendo filtrado. |
— OnNewRecord:TDataSetNotifyEvent |
Evento disparando quando um novo registro está para ser inserido. |
— OnPostError:TDataSetErrorEvent |
Evento disparando quando ocorre um erro de gravação. |
TFieldDefs
Classe de objetos que guardam em si um conjunto de definições de campos associados a uma tabela. Esse conjunto é usado pelo TDataSet para averiguar qual campo está sendo exigido e como ele deve se comportar.
Propriedades do TFieldDefs
Propriedade | Descrição |
Count | Propriedade que retorna a quantidade de definições da lista. |
Items[Index:Integer] | Propriedade que retorna o item da lista especificado pelo índice. |
Métodos e Eventos Públicos
— constructor Create(DataSet: TDataSet); |
Método usado para criar o objeto. |
— destructor Destroy; override; |
Método usado para destruir o objeto. |
— procedure Add(const Name: string; DataType: TFieldType; Size: Word; Required: Boolean); |
Método usado para adicionar um campo à lista. |
— procedure Assign(FieldDefs: TFieldDefs); |
Método usado para copiar o conjunto de campos de um objeto para outro. |
— procedure Clear; |
Método usado para limpar a lista de campos do objeto. |
— function Find(const Name: string): TFieldDef; |
Método usado para procurar o objeto de definição de campo pelo nome do campo. |
— function IndexOf(const Name: string): Integer; |
Método usado para recuperar o índice de um campo pelo seu nome. |
— procedure Update; |
Método usado para atualizar o objeto. |
TFieldDef
Classe de objetos que carrega informações sobre um campo de uma tabela individualmente. O conjunto de objetos dessa classe, relativos a uma só tabela, forma um objeto da classe anterior. Arquivo fonte:WOLDBK01.PP.
Propriedades do TFieldDef
Propriedade | Descrição |
DataType | Propriedade que representa o tipo de dado que o campo suporta. É do tipoTFieldType. |
FieldClass | Propriedade que retorna a classe do campo que o objeto representa. É do tipoTFieldClass. |
FieldNo | Propriedade que retorna o número associado ao campo. |
InternalCalcField | Propriedade que indica se o campo deve ser calculado ou não. |
Name | Propriedade que carrega o nome do campo. |
Precision | Propriedade que indica a precisão do campo no caso dele ser numérico. |
Required | Propriedade que indica se o campo é obrigatório ou não. |
Size | Propriedade que indica o tamanho da informação do campo. |
Métodos e Eventos Públicos
— constructor Create(Owner:TFieldDefs; const Name:String; DataType:TFieldType; Size:Word; Required:Boolean; FieldNo:Integer); |
Método usado para criar o objeto inserindo o mesmo seu proprietário Owner. |
— destructor Destroy; override; |
Método usado para destruir o objeto. |
— function CreateField(Owner:TWOLRoot):TField; |
Método usado para criar um campo e retorná-lo. |
Retirado de: http://wol.sourceforge.net/docdataset.html 31/08/2010
Deixe um comentário