Delphi e Banco de Dados Parte I - Arquitetura de Acesso a Dados do Delphi

Viso Geral
Utilizando o Delphi, voc pode criar aplicaes de bancos de dados que trabalhem diretamente com bancos de dados desktop ou servidores de bancos de dados remotos, tais como Oracle, Sybase, e bancos de dados padro ODBC. Este captulo o introduz arquitetura das aplicaes Client/Server, bem como as ferramentas utilizadas para constru-las.

Caractersticas e Capacidades de Bancos de Dados Introduo

Voc pode construir uma aplicao de bancos de dados utilizando as ferramentas de desenvolvimento de banco de dados do Delphi, componentes Data Access e Data Control. Em uma aplicao de bancos de dados Delphi, os componentes se comunicam com o Borland Database Engine (BDE), que por sua vez, comunica-se com suas outras fontes: Dados locais, tais como dBASE, Paradox e InterBase for Windows Dados remotos, tais como Oracle, Sybase e InterBase

Relacionamento entre o Delphi e a Conectividade de Banco de Dados

O diagrama a seguir mostra o relacionamento entre as ferramentas do Delphi, aplicaes de banco de dados do Delphi, o BDE, e os dados:

Ferramentas de Bancos de Dados Introduo

Voc pode utilizar diversas ferramentas de bancos de dados na construo deste tipo de aplicao.

Ferramentas de Bancos de Dados

As ferramentas a seguir permitem construir aplicaes de banco de dados que podem trabalhar com arquivos de dados locais ou em um servidor de rede local: Borland Database Engine (BDE) SQL Links Database Desktop Componentes Data Access Componentes Data Control

Borland Database Engine (BDE) Introduo

O Borland Database Engine (BDE) construdo no Delphi para oferecer uma conexo entre controles Data Access e dados de vrias fontes como Paradox, dBASE, Oracle, e InterBase. Bancos de dados, linguagens e ferramentas da Borland compartilham o mesmo Borland Database Engine. Este design em comum permite que os componentes sejam intercambiados para construir um ambiente de aplicao Client/Server que atenda s suas necessidades.

Relacionamento entre o BDE e Outros Produtos Borland

O Borland Database Engine um componente integral do dBASE for Windows, Paradox for Windows, Delphi, e ReportSmith. Tambm est disponvel como biblioteca API de engine de banco de dados para programadores C e C++. O diagrama a seguir mostra o relacionamento entre o Borland Database Engine e os diversos produtos Borland:

O Borland Database Engine permite que ferramentas e aplicaes Borland conectem transparentemente dados residindo no dBASE, Paradox , Oracle, Sybase, Interbase, Informix, DB2, e qualquer banco de dados que utilizem o Open Database Connectivity (ODBC).

SQL Links Introduo

O SQL Links d s suas aplicaes Delphi acesso a dados localizados em servidores Workgroup baseados em SQL, incluindo Sybase, voc pode construir comandos SQL e pass-los atravs de um diver SQL Link ao servidor para execuo.

Criando Aliases
Um Alias consiste de um nome e conjunto de parmetros que descrevem recursos de rede e especificam a localizao das tabelas do banco de dados. Um alias necessrio para acessar banco de dados SQL. Embora voc possa personalizar um alias aps cri-lo, mais fcil escolher parmetros do diver que combinem com sua instalao servidora antes de criar os aliases para bancos de dados SQL. Desta forma, qualquer alias que voc crie herdam estes parmetros.

Configurando o Ambiente SQL

O diver SQL Link utiliza os parmetros default quando instalado pela primeira vez. Como os parmetros do SQL Link para seu diver serve como modelo para cada alias que voc crie, voc deve determinar se estes parmetros esto corretos para sua instalao servidora antes de criar aliases para seu banco de dados SQL. Para modificar seu ambiente SQL, utilize o BDE Configuration Utility (BDECFG.EXE) instalado com o Delphi. Os aliases so armazenados no arquivo de configurao IDAPI (IDAPI.CFG).

Database Desktop Introduo

O Database Desktop (DBD) uma ferramenta de definio e manuteno de banco de dados que lhe permitem consultar, criar, reestruturar, modificar e copiar tabelas de banco de dados. O Database Desktop tambm pode copiar dados e informaes do dicionrio de dados de um formato para outro.

Inicializando o Database Desktop

Voc pode inicializar o Database Desktop no Gerenciador de Programas, d um duplo-clique sobre o cone do Database Desktop no grupo de programa Delphi. Quando selecionar uma tabela, a tabela aparece na janela do Database Desktop, como mostrado no exemplo a seguir:

Novos Recursos do Database Desktop

O Database Desktop contm as seguintes melhorias: Recurso Menu Utilities Descrio O Database Desktop agora inclui um menu Utilities com os seguintes comandos: Add Adiciona registros de uma tabela em outra tabela Copy Cria uma cpia de uma tabela, query QBE, ou comando SQL Delete Deleta uma tabela, query QBE, ou comando SQL Empty Remove todos os registros de uma tabela Passwords Permite adicionar e remover senhas da lista de senhas utilizadas na sesso atual Rename Altera o nome de uma tabela, query QBE, ou comando SQL Sort Ordena os dados em uma registros que existam em outra tabela Substract Remove de uma tabela de registro que existam em outra tabela Voc pode utilizar os seguintes comandos com tabelas SQL: Add Copy Delete Empty Acesso SQL est disponvel para operaes de queries e tabelas, incluindo criao e reestruturao. Voc pode executar comandos SQL utilizando o SQL Editor.

SQL

Documentao do Database Desktop

O Delphi fornece a seguinte documentao do Database Desktop: Documentao Online Help Descrio Documentao completa do Database Desktop com os recursos usuais de help atravs da tecla F1, procura de tpicos e help sensvel ao contexto. Alm disso muitos tpicos possuem help orientado tarefa Documentao completa sobre o desenvolvimento de aplicaes com um apndice que resume os recursos do Database Desktop Documentao completa sobre a utilizao do Database Desktop, disponvel no CD-ROM do Delphi

Delphi Database Application Developers Guide Database Desktop Users Guide

Descrio dos Componentes Data Access Introduo

Os componentes Data Access esto na pgina Data Access da Component Palette. Estes componentes permitem construir aplicaes de bancos de dados. Eles, juntamente com os componentes Data Control, so

componentes data-aware. Componentes data-aware so componentes que tem cincia de dados e sua estrutura em um banco de dados. Quando voc constri uma aplicao de banco de dados, voc insere componentes Data Access em form e atribui propriedades que especificam o banco de dados, tabelas e registros a serem utilizados com este form. Muito embora componentes Data Access no sejam visveis durante a execuo, eles trabalham em segundo plano para regular o acesso aos dados.Os componentes Data Access aparecem na Component Palette.

Descrio dos Componentes Data Access

A tabela a seguir descreve os componentes Data Access na Component Palette: cone TDataSource Visual No Propriedades, Eventos, ou Mtodos Significantes Atua como um canal entre um objeto Ttable ou P:AutoEdit Tquery e componentes de edio de dados como P:State TDBGrid P:Enable P:Dataset P:OnDataChange E:OnUpdateData M:Edit Recupera dados de tabelas de bancos de dados P:DatabaseName atravs do BDE e os passa para um ou mais P:TableName componentes data-aware P:ReadOnly P:Exclusive P:IndexName P:Tag P:MasterFields P:MasterSource M:GotoCurrent Utiliza comandos SQL para recuperar dados de uma P:SQL tabela atravs do BDE, ou utiliza comandos SQL P:DataSource para enviar dados de um componente a um banco de P:Local dados atravs do BDE P:ParamCount P:Param P:Unidirectional P:ExecSQL Permite que aplicaes executem stored procedures P:DatabaseName do servidor M:Prepare M:ExecProc M:Open Define uma conexo contnua um banco de dados P:Active P:DatabaseName P:Handle P:PassWord M:Close M:Create M:Destroy M:Open Copia a estrutura de uma tabela e seus dados . Pode P:Mode ser utilizado para mover tabelas inteiras de um banco P:Source de dados a outro P:Destination P:ChangedTable Name P:KeyViolTable Name P:ProblemTable Name M:Execute Propsito

TTable

No

TQuery

No

StoredProc

No

TDatabase

No

TBacthMove

No

TReport

Sim

Permite a criao e impresso de relatrios de bancos de dados atravs do ReportSmith

P:ReportName P:ReportDir P:Preview P:Run P:AutoUnload P:UnitialValues M:RunMacro M:Connect M:SetVariable M:ReCalcReport

Descrio dos Componentes Data Control Introduo

Os componentes Data Control do s suas aplicaes Delphi de banco de dados uma interface visual consistente, quer sua aplicao acesse um arquivo de banco de dados local ou um servidor remoto. Baseado na instalao padro, os componentes Data Control esto localizados na pgina Data Controls da Component Palette. Estes componentes fornecem um conjunto de componentes data-aware de interface de usurio, que voc pode utilizar para criar aplicaes baseadas em forms. Como mencionado anteriormente, os componentes Data Control e Data Access so data-aware. Alm da funo de um componente Standard, componentes Data Control tambm podem exibir dados de um campo de uma tabela de um banco de dados ou enviar dados uma tabela de um form. Os componentes Data Control aparecem na Component Palette.

Descrio dos Componentes Data Control

A tabela a seguir descreve os componentes Data Control na Component Palette: cone Visual Propsito Propriedades, Eventos, ou Mtodos Significantes TDBGrid Sim Permite visualizar e editar dados em P:Options formato tabular (tipo planilha). Faz uso P:ReadOnly extensivo das propriedades do Tfield para P:Fields determinar a visibilidade de uma coluna, P:SelectedField modo de exibio, e assim por diante. P:FieldCount TDBNavigator Sim Permite fazer o seguinte: P:Data Source -Mover o ponteiro de registro da tabela P:VisibleButtons atual para frente ou trs -Iniciar o modo Insert ou Edit -Efetuar a insero de registros novos ou modificados (Post) TDBLable Sim Permite exibir um campo de um registro P:DataSource atualmente ativo. a verso data-aware do P:DataField componente TLabel P:Caption P:FocusControl P:Alignment P:AutoSize P:WordWrap P:Transparent TDBEdit Sim Permite exibir ou editar um campo de um P:DataSource registro ativo. a verso data-aware do P:DataField componente TEdit P:EditMask P:Modified

TDBMemo

Sim

Permite exibir ou editar BLOBs de um registro ativo. a verso data-aware do componente TMemo

TDBImage

Sim

TDBListBox

Sim

Permite exibir, recortar, ou colar imagens bitmap BLOB para e de um registro ativo. a verso data-aware do componente TImage Permite exibir valores de uma coluna de uma tabela. a verso data-aware do componente TListBox

TDBCombo Box

Sim

Permite exibir ou editar valores de uma coluna de uma tabela. a verso dataaware do componente TComboBox

P:MaxLength P:ReadOnly P:AutoSelect P:SelText P:SelStart P:SelLentgh P:PassWordChar P:AutoSize M:SelectAll M:ClearSelection M:CutToClipboard M:CopytoClipboard M:PasterFrom Clipboard P:DataSource P:DataField P:Text P:ReadOnly P:Modified P:MaxLength P:Lines P:SelText P:SelStart P:SelLength P:PassWordChar P:AutoSize P:ScrollBars P:WordWrap P:WantTabs P:M:Add M:Delete M:Insert M:CutToClipboard M:CopyToClipboard M:PasterFromClipboard M:SelectAll P:DataSource P:DataField P:Picture P:AutoDisplay P:ReadOnly P:DataField P:Items P:ItemIndex M:Add M:Delete M:Insert P:ReadOnly P:DataSource P:DataField P:Items P:ItemIndex P:Sorted P:SelText P:SelStart P:SelLength M:Add

TDBCheck Box

Sim

Permite exibir ou editar um campo de dado Booleano de um registro ativo. a verso data-aware do componente TCheckBox Permite exibir ou definir valores de colunas. a verso data-aware do componente TGroupBox populado com radio buttons Permite exibir dados de uma tabela de busca durante a execuo. a verso dataaware do componente TListBox Permite exibir dados de uma tabela de busca durante a exibio. a verso dataaware do componente TComboBox

TDBRadioGroup

Sim

TDBLookupList

Sim

TDBLookupCombo

Sim

M:Delete M:Insert M:SelectAll P:DataSource P:DataField P:ValueChecked P:ValueUnchecked P:ReadOnly P:DataSource P:DataField P:Items P:Value P:ReadOnly P:DataField P:DataSource P:LookupDisplay P:LookupField P:LookupSource P:LookupField P:LookupDisplay P:DataSource P:DataField

Parte II - Adicionando Componentes de Banco de Dados uma Aplicao

Viso Geral
Os componentes de banco de dados e suas capacidades descritas neste captulo fornecem as ferramentas necessrias para a criao de aplicaes que utilizem bancos de dados local, baseado em PC e remotos, baseados em servidores SQL. Este captulo aplica os componentes de banco de dados no desenvolvimento de uma aplicao. Estes componentes esto nas pginas Data Access e Data Controls da Component Palette.

Conceito de um DataSet no Delphi

Introduo
Para manipular e consultar bancos de dados, voc precisa entender o conceito de dataset. Um dataset no Delphi um objeto que consiste de uma srie de registros, cada um contendo qualquer quantidade de campos e um ponteiro para o registro atual. O dataset pode ter uma correspondncia direta, um-para-um, com uma tabela fsica, ou, como um resultado de uma query, pode ser um subconjunto de uma tabela ou uma juno de diversas tabelas.

Tipo de Objeto TDataSet

Um dataset no Delphi o tipo de objeto TDataSet e uma classe abstrata. Uma classe abstrata uma classe de onde voc pode derivar outras classes, mas no pode criar uma varivel desta classe. Por exemplo, ambos os componentes Query e Table classificam-se como componentes TDataSet porque cada um foi derivado do objeto TDataSet. Note que voc no encontrar nenhum componente chamado TDataSet na Component Palette. O TDataSet contm as abstraes necessrias para manipular diretamente uma tabela. a ferramenta utilizada para abrir uma tabela e navegar por suas colunas e linhas. Os componentes neste captulo so referenciados pelo seu tipo de objeto (identificado no Delphi pelo seu nome com o prefixo T). O termo componente DataSet utilizado para referenciar um componente Table,

Query, ou StoredProc. TTable, TQuery, e TStoredProc so descendentes de TDataSet, ou seja, eles herdam as propriedades de TDataSet.

Diagrama dos componentes DataSet

O diagrama a seguir mostra o conceito dos componentes DataSet, que so componentes derivados do tipo de objeto TDataSet:

Utilizando o Componente e DataSource

Introduo
O componente DataSource atua como intermedirio entre o componente DataSet (TTable, TQuery, ou TStoredProc) e os componentes Data Control. Dentre os componentes Data Control incluem DBGrid, e DBText entre outros. Esta seo explica: Qual o papel do componente DataSource em uma aplicao de banco de dados Como utilizar propriedades e eventos do DataSource Como adicionar componentes DataSource sua aplicao

Papel de um Componente DataSource

Um Componente DataSource gerencia o relacionamento entre uma tabela de banco de dados e a representao deste dado em seu form. um intermedirio entre os componentes DataSet e DataControl. Componentes DataSet gerenciam a comunicao com o Borland Database Engine (BDE), e o componente DataSource gerencia a comunicao com componentes data-aware Data Control. Em uma tpica aplicao de banco de dados, um componente DataSource associado com um componente DataSet (Table ou Query) e um ou mais componentes Data Control (tais como DBGrid). O diagrama a seguir mostra este relacionamento:

Utilizando Propriedades e Eventos DataSource

As propriedades e eventos chave do componente DataSource so: Propriedade DataSet Propriedade Enabled Propriedade AutoEdit Evento OnDataChange Evento OnUpdateData Evento OnStateChange Cada uma destas propriedades e eventos so discutidas nas sees a seguir:

Utilizando a propriedade DataSet do Componente DataSource

A propriedade DataSet identifica o nome de um componente DataSet. Voc pode atribuir propriedade DataSet atravs de programao ou utilizando o Object Inspector. O valor atribuido propriedade DataSet o nome de um objeto TDataSet. Por exemplo, a linha de cdigo a seguir atribui um nome ou objeto TQuery propriedade DataSet de um componente ou objeto DataSource. DataSource1.DataSet := Query1

Voc pode inserir diversos componentes Query, Table, e StoredProc em um form a atribuir a propriedade DataSet baseado em uma condio no programa. Voc tambm pode atribuir a propriedade DataSet a um nome ou objeto TQuery, TTable, ou TStoredProc encontrado em outro form utilizando o identificador da unit do form. Por exemplo, aps incluir a Unit1 na clusula uses, voc pode digitar o seguinte: DataSource1.DataSet := Unit1.Form1.Table1;

Utilizando a Propriedade Enable do TDataSource

A propriedade Enable inicia ou termina a comunicao entre os componentes TDataSource e DataControl. Os valores da propriedade Enable so: True Os componentes Data Control conectados ao TDataSource "enxergamas alteraes do dataset. False Voc pode manipular o TDataSet atravs de programao sem que os componentes Data Control "enxerguem as alteraes. Por exemplo, o cdigo a seguir desabilita o TDataSource, procura por um valor coincidente de nmero do cliente, e depois habilita o TDataSource para que ou a linha do cliente ou a ltima linha seja exibida. DataSource1.Enabled : = False; Table.First; While not Table1.EOF do begin if Table1.FieldByName(NoCliente).AsString = LookupCust then Break; Table1.Next; end; DataSource1.Enabled : = True;

Utilizando a propriedade Enable permite que voc desconecte temporariamente o componente visual Data Control do TDataSource. No exemplo anterior, se a tabela contiver 2000 linhas e o TDataSource estiver habilitado, o usurio de sua aplicao veria 2000 linhas rolando na tela durante esta operao. Desabilitando TDataSource uma maneira mais eficiente de se pesquisar em um grande nmero de linhas, pois o componente Data Control no atrasar a procura exibindo cada linha conforme esta for sendo alterada.

Utilizando a Propriedade AutoEdit de TDataSource

A propriedade AutoEdit controla como a edio iniciada nos componentes Data Control. Os valores das propriedades AutoEdit so: True O modo de edio iniciado sempre que o usurio comece a digitar dentro de um componente Data Control. False O modo de edio iniciado quando o mtodo Edit invocado, por exemplo, aps o usurio dar um clique sobre o boto Edit do Navigator. Este parmetro controla a edio. Dentro do seu cdigo, voc pode utilizar os seguintes mtodos para controlar as alteraes nos dados da tabela quando AutoEdit estiver como False: Edit Post Cancel O cdigo a seguir um exemplo utilizando o mtodo Post: DataSource1.DataSet.Edit; {Start edit mode} DataSource1.DataSet.Fields [3] .AsString : = Hello; DataSource1.DataSet.Post;

Utilizando o Evento OnDataChange de TDataSource

O evento OnDataChange ocorre sempre que: A propriedade State do TDataSource mudar do estado dsInactive Ocorrer uma alterao de campo, registro, tabela, query ou layout Este evento associado com alteraes na exibio de dados, tais como rolar para um novo registro ou ativando TDataSource. Este evento til para monitorar alteraes nos componentes Data Control.

Utilizando o Evento OnUpdateData de TDataSource

O evento OnUpdateData ocorre quando: O registro atual no TDataSet estiver para ser atualizado Uma alterao estiver para ser confirmada Este evento til na monitorao de alteraes nos dados de uma tabela. Por exemplo, voc pode utilizar este evento para criar auditor de alteraes nos dados em sua aplicao.

Utilizando o Evento OnStateChange de TDataSource

O evento OnStateChange ocorre sempre que a propriedade State de DataSource for alterada. Este evento til para monitorao de alteraes na propriedade State. A propriedade State pode ter os seguintes valores: dsInactive dsBrowse dsEdit dsInsert dsSetKey dsCalcFields

Passos para Adicionar um Componente DataSource

Execute os passos a seguir para adicionar um componente DataSource ao form: Passo 1 2 3 4 Ao Utilizando a pgina Data Access da Component Palette, adicione o componente DataSource ao form. Utilize o Object Inspector para definir a propriedade DataSet ou escreva o cdigo apropriado. Defina as propriedades AutoEdit e Enabled, ou ambas, apropriadamente. Escreva event handlers para um ou todos os seguintes eventos: OnDataChange event OnUpdateData event OnStateChange event

Utilizando o Objeto TDataSet Introduo

Geralmente, quando voc manipula um componente Table ou chama um mtodo TTable, voc est utilizando um mtodo derivado do objeto TDataSet. TDataSet oferece um grande nmero de propriedade, mtodos e eventos.

Propriedades do Objeto TDataSet

A tabela a seguir descreve as propriedades mais importantes do objeto TDataSet: Propriedade Active Descrio Abre ou fecha um componente DataSet. Abrir um componente DataSet estabelece a conexo entre o componente e o banco de dados. Voc pode definir a propriedade Active no Object Inspector durante o design ou diretamente em seu cdigo, como segue: if DeActivate = true then Table1.Active : = True Else Table1.Active : = False; EOF (End of File) BOF (Beginning of File) Fields Os mtodos Open e Close tambm definem a propriedade Active de TDataSet. Propriedades somente de leitura (read-only) com os seguintes valores: EOF definido para True quando voc tenta mover para alm da ltima linha do dataset BOF definido para True quando o componente DataSet aberto ou quando o ponteiro do DataSet para a linha atual estiver posicionado na primeira linha. Um array do objeto TField. Voc pode definir e ler dados dos campos da linha atual utilizando esta propriedade. Por exemplo: Table1.Fields[0]. AsString : = Hello; Table1.Fields[1] .AsString : = World;

Mtodos do Objeto TDataSet

O objeto TDataSet fornece ao componente Table diversos mtodos. Alguns dos mtodos mais importantes so mostrados na tabela a seguir: Mtodo Descrio

Open Close Refresh

Operam nos datasets, como segue: O mtodo Open equivalente a definir a propriedade Active para True. O mtodo Close define a propriedade Active para False O mtodo Refresh permite ler novamente o dataset do banco de dados . Se voc precisa se assegurar que os dados so os mais atuais, contendo quaisquer alteraes feitas por outros usurios, utilize o mtodo refresh. Um componente Table, Query, ou StoredProc deve estar aberto com open quando Refresh for chamado. Um exemplo destes mtodos : Table1.Open; Table1.Close; Table1.Refresh; Permite navegar ou alterar a linha atual do dataset. A seguir, um exemplo utilizando vrios destes mtodos: Table1.First While not Table1.EOF do Begin {Seu cdigo aqui} Table1.Next; end; O mtodo MoveBy move um nmero especificado de linhas. Por exemplo: Table1.MoveBy(3) move 3 linhas para cima. Table1.MoveBy(-2) move 2 linhas para trs.

First Last Next Prior MoveBy

Insert Edit Delete Append Post Cancel

Permite modificar os dados em uma tabela de banco de dados, como segue: O mtodo Insert permite adicionar uma linha tabela. Por exemplo: Table2.Insert; Table2.Fields[0] .AsInteger : = 20; Table2.Fields[1] .AsString : = News; Table2.Fields[ 2] .AsString : = 5 Horas; Table2.Post; O mtodo Post faz com que a operao Insert Update ou Delete ocorra. O mtodo Cancel faz com que uma operao Insert Delete, Edit ou Append no ocorrida seja cancelada. Fornece uma maneira de acessar dados de uma coluna especificando no nome da coluna do banco de dados. Como no exemplo a seguir: s : = Table2.FieldByName (area) .AsString; Procura atravs dos datasets, como segue: SetKey alterna a tabela para o modo de pesquisa (search). Enquanto neste modo, a propriedade Fields tem uma utilizao especial. GotoKey inicia a pesquisa por um valor coincidente com o valor encontrado em Fields[n]. Fields[n] contm o valor a ser pesquisado por valores em outras colunas definindo a coluna Fields correspondente. O exemplo a seguir mostra um exemplo da utilizao de SetKey e GotoKey: Table1.SetKey; Table1.Fields[0] .AsString Edit1.Text; Table1.GotoKey; Permite ser mais seletivo nos dados que sua aplicao seleciona ou utiliza na tabela.

FieldByName

SetKey GotoKey

SetRangeStart

SetRangeEnd ApplyRange

Geralmente uma tabela grande e voc quer selecionar somente uma srie de valores da tabela. O mtodo Range permite fazer tal seleo. Exemplo: Table1.SetRangeStart Table1.Fields[0] .AsString : = Edit1.Text; Table1.SetRangeEnd Table.Fields[0] .AsString : = Edit2.Text; Table1.ApplyRange;

A primeira chamada SetRangeStart o coloca no modo range e a propriedade Fields toma um significado especial. Utilize a propriedade Fields para especificar o valor de incio para a srie. A chamada para SetRangeEnd inicia um modo onde os valores digitados na propriedade Fields so utilizadas como o valor final da srie. ApplyRange faz com que o comando seja processado. Um dataset criado contendo os valores entre os valores de incio e final. FreeBookmark Permite criar um marcador de linha em uma tabela ou query e depois retornar esta linha GeTBookMark posteriormente. Os mtodos Bookmark utilizam um tipo de objeto chamado TBookMark. GotoBookmark Por exemplo: Var Marker : TBookMark; Begin Marker : = Table2.GeTBookMark; Table2.GotoBookmark(Marker); Table2.FreeBookmark(Marker); O mtodo GeTBookMark aloca um marcador para linha da tabela. O mtodo GotoBookmark altera a localizao na tabela para a linha indicada pelo Bookmark alocado anteriormente. Utilize o mtodo FreeBookmark para liberar o espao alocado para o marcador.

Eventos do Objeto TDataSet

O objeto TDataSet permite responder a um grande nmero de eventos. A tabela a seguir descreve diversos deles: Eventos OnOpen OnClose OnNewRecord BeforeInsert AfterInsert BeforeEdit AfterEdit BeforePost Descrio Permite construir e controlar o comportamento de aplicaes de bancos de dados. Exemplos de utilizao seguem: Evento BeforePost para validar os campos de um registro antes de inser-lo ou atualizlos Evento AfterPost para gravar um registro de auditoria quando necessrio Evento OnDelete para gravar cdigo que efetue a deleo em cascata quando apropriado

AfterPost OnCancel OnDelete

Utilizando o Objeto TFields Introduo

O objeto TField, como o objeto TDataSet, no encontrado na Component Palette. uma propriedade do objeto TDataSet (e Componente Table). Algumas propriedades no Object Inspector so objetos com seu prprio conjunto de propriedades. TFields um deles. Esta seo descreve a propriedade Fields, que objeto TFields com seu prprio conjunto de propriedades.

Propriedades Fields do Objeto TDataSet

Uma das propriedades do Objeto TDataSet (portanto, os componentes Table, Query, e StoredProc) a propriedade Fields. Como discutido anteriormente neste captulo, a propriedade Fields permite acessar os campos individuais do dataset. A propriedade Fields um array dos objetos TFields. Este array ou lista gerada dinamicamente durante a execuo ( e portanto, no aparece na lista de propriedades do Object Inspector). O array representa cada uma das colunas no componente Table. Objetos estticos TFields so visveis no Object Inspector. Sees posteriores deste captulo explicam como criar uma lista esttica de objetos TField, mas primeiro, voc deve entender algumas das propriedades destes objetos.

Propriedades do Objeto TField

Voc deve entender em diversos exemplos o uso do mtodo AsString. O objeto TField no faz nenhuma suposio sobre o tipo de dado que ele contm. Ele possui diversos mtodos que permitem definir ou recuperar os valores de um campo. Alguns destes mtodos so: AsBoolean AsFlot AsInteger AsString O cdigo a seguir mostra alguns exemplos para a utilizao de cada um deles: Fields[0] .AsString : = sto uma string; FieldByName ('Casado) .AsBoolean : = False; SomaDespesas : = Fields[5] As.Float; NoPedido ; = Fields[3] .AsInteger;

Outras Propriedades do Objeto TField

A tabela a seguir descreve diversas outras propriedades importantes do objeto TField: Propriedade EditMask IsNull Size Text FieldName Descrio Permite definir uma mscara de input para o campo Determina se um campo no possui valor. uma propriedade read-only. Determina o tamanho de um campo. uma propriedade read-only. Permite definir ou recuperar um valor de string de um campo Fornece o nome do campo do banco de dados. uma propriedade read-only.

Utilizando o Componente Table Introduo

O componente Table um componente TDataSet que comunica com uma tabela de banco de dados atravs do BDE. A tabela do banco de dados pode ser tanto local ou em um servidor remoto. Esta seo discute: O papel do componente Table Propriedades, eventos e mtodos do componente Table Passos para adicionar um componente Table sua aplicao

O Papel do Componente Table

O diagrama a seguir mostra que TTable derivado de TDBDataSet por herana e, por sua vez, TDBDataSet derivado de TDataSet. Muito da funcionalidade do componente Table baseado neste relacionamento. TTable herda de TDataSet a capacidade de manipular datasets. Ele fornece mtodos, tais como Next, First, Last, Edit, SetRange e Insert. TDbDataSet permite que TTable suporte trabalhar com senhas e outras tarefas associadas com a ligao de sua aplicao com um banco de dados. TTable adiciona mtodos e atributos para manipulao de ndices, e para armazenar o relacionamento entre esta tabela e outra em sua aplicao .

Propriedades do Componente Table

Como vimos, muito da funcionalidade do componente Table vm do objeto TDataSet. O componente Table permite utilizar as propriedades, mtodos e eventos TDataSet, mas possui diversas propriedades prprias relativas a tabelas de banco de dados. Por exemplo, o componente Table permite que voc: Especifique ndices a serem utilizados Crie um cursor Linkado Cursores Linkados coordenam dois ou mais componentes DataSet para criar forms master-detail. A tabela a seguir descreve as propriedades mais importantes do componente Table: Propriedade DatabaseName Descrio Especifica o seguinte: O diretrio local de um banco de dados que contenha a tabela a ser visualizada O alias de um banco de dados remoto Especifica o nome do banco de dados a ser visualizado

TableName

Exclusive

Controla o acesso de usurio ao banco de dados. Os valores so: True Assegura que nenhum outro usurio acesse ou modifique a tabela enquanto voc a mantiver aberta False Permite que outros usurios acessem ou modifiquem a tabela enquanto voc a mantiver aberta. Este o default. Identifica um ndice secundrio para Table. Voc no pode alterar IndexName enquanto a tabela estiver ativa Especifica o nome dos campos ligados ou campos na propriedade MasterFields para criar um cursor linkadoa uma tabela secundria Para especificar diversos campos, voc deve separar os nomes de campos com uma barra vertical (|) . Especifica o TdataSource de onde TTable obter os dados para a tabela master Pe a tabela em modo somente-leitura. Os valores so: True Previne o sistema de gravar alteraes ao banco de dados onde a tabela resida False Permite que o sistema grave alteraes ao banco de dados onde a tabela resida

IndexName MasterFields

MasterSource ReadOnly

Passos para Adicionar um Componente Table

Execute os passos a seguir para adicionar um componente table ao form: Passo Ao 1 Utilizando a pgina Data Access da Component Palette, adicione um componente Table ao form. 2 No Object Inspector , localize a propriedade DatabaseName e digite o diretrio onde o banco de dados reside, ou digite um nome de alias do banco de dados. 3 Localize a propriedade TableName e digite o nome da tabela ou selecione uma tabela da lista dropdown. 4 Adicione um componente DataSource e defina o valor da propriedade de DataSet igual ao do componente Table. 5 Adicione componentes Data Control e conecte-os ao componente DataSource para exibir dados da tabela do banco de dados.