Mais um pouco sobre o TDataset

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 uma resposta

Preencha os seus dados abaixo ou clique em um ícone para log in:

Logotipo do WordPress.com

Você está comentando utilizando sua conta WordPress.com. Sair / Alterar )

Imagem do Twitter

Você está comentando utilizando sua conta Twitter. Sair / Alterar )

Foto do Facebook

Você está comentando utilizando sua conta Facebook. Sair / Alterar )

Foto do Google+

Você está comentando utilizando sua conta Google+. Sair / Alterar )

Conectando a %s