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