MECANISMOS DE ACESSO

PRINCIPAIS PROPRIEDADES DA CLASSE TDATASET Apresenta-se a seguir uma descrio das principais propriedades da classe TDataSet. Desta maneira, podemos descrever estas propriedades de uma nica vez, ao invs de falar sobre elas cada vez que abordarmos uma das classes derivadas da classe TDataSet. Para uso pessoal. Este material no pode ser utilizado em Salas de Aula e para ministrar treinamentos.

ACTIVE Essa propriedade definida como uma varivel booleana, e define se a tabela (ou conjunto de tabelas) associada ao componente est ou no ativa. Conforme ser visto posteriormente, atribuir o valor true a essa propriedade equivale a executar o mtodo Open do componente. Da mesma forma, atribuir o valor false a essa propriedade equivale a executar o mtodo Close do componente. AUTOCALCFIELDS Essa propriedade definida como uma varivel booleana, e define se o procedimento associado ao evento OnCalcFields do componente deve ser executado sempre que houver uma alterao nos dados armazenados na tabela representada pelo componente. Os campos calculados so aqueles cujo valor pode ser diretamente obtido em funo dos valores armazenados em outros campos da tabela, razo pela qual no precisam ser armazenados permanentemente na tabela. A definio da frmula utilizada para o clculo dos valores desses campos feita no procedimento associado ao evento OnCalcFields do componente, conforme ser exemplificado posteriormente. BOF Essa propriedade definida como uma varivel booleana, e define se o registro corrente o primeiro registro da tabela representada pelo componente. uma propriedade apenas de leitura, e tem o valor true em cada uma das seguintes situaes: Quando se estabelece o acesso tabela representada pelo componente, definido-se como True o valor da sua propriedade Active, ou aps uma chamada ao seu mtodo Open. Aps uma chamada ao mtodo First do componente. Aps uma chamada ao mtodo Prior do componente, quando o registro corrente j o primeiro registro da tabela. EOF Essa propriedade definida como uma varivel booleana, e define se o registro corrente o ltimo registro da tabela representada pelo componente. uma propriedade apenas de leitura, e tem o valor True em cada uma das seguintes situaes: Quando se estabelece o acesso tabela representada pelo componente, definido-se como True o valor da sua propriedade Active (ou aps uma chamada ao seu mtodo Open) e a tabela no possui nenhum registro armazenado. Aps uma chamada ao mtodo Last do componente. Aps uma chamada ao mtodo Next do componente, quando o registro corrente j o ltimo registro da tabela. Para uso pessoal. Este material no pode ser utilizado em Salas de Aula e para ministrar treinamentos.

FIELDCOUNT Essa propriedade definida como uma varivel inteira, e define o nmero de campos da tabela representada pelo componente. uma propriedade apenas de leitura, e no pode ter o seu valor diretamente alterado pelo usurio. importante salientar que essa propriedade retorna o nmero de campos acessado pelo componente que no necessariamente igual ao nmero de campos reais da tabela representada pelo componente.

Uma forma de se alterar o nmero de campos acessados pela tabela consiste em utilizar o Fields Editor, que permite que se definam os campos da tabela que sero realmente acessados pelo componente. FIELDS Essa propriedade definida como uma array de objetos da classe TField, e permite o acesso a campos individuais do registro corrente da tabela representada pelo componente. Nesse caso, o primeiro campo representado pelo ndice 0, sendo o n-zimo campo representado pelo ndice n-1. importante lembrar que esses campos so aqueles realmente acessados pelo componente, e no so necessariamente todos os campos da tabela por ele representada. Para acessar os valores armazenados em cada campo acessado pelo componente, deve-se utilizar uma das propriedades de converso da classe TField, dentre as quais podem-se destacar: AsString, para tratar o valor armazenado no campo como uma string. AsInteger, para tratar o valor armazenado no campo como um nmero inteiro. AsFloat, para tratar o valor armazenado no campo como um nmero real. AsBoolean, para tratar o valor armazenado no campo como um valor booleano. AsCurrency, para tratar o valor armazenado no campo como um valor monetrio. AsDateTime, para tratar o valor armazenado no campo como um valor no formato Data/Hora. AsVariant, para tratar o valor armazenado no campo como um valor do Variant (que pode armazenar qualquer tipo de dado). Dessa maneira, se quisermos exibir o valor armazenado no dcimo campo acessado pelo componente, devemos empregar uma linha de cdigo com a seguinte sintaxe: ShowMessage(Table1.Fields[9].AsString); Nesse caso, Table1 o nome do componente que representa a tabela. FIELDVALUES Essa propriedade definida como uma array de valores do tipo Variant, indexado pelos nomes dos campos da tabela representada pelo componente. interessante destacar que essa a propriedade default da classe TDataSet e das classes dela derivadas por herana. Conseqentemente, se TblPais o nome de um componente de uma classe derivada de TDataSet, as linhas de cdigo a seguir so equivalentes. TblPais[Nome] := Brasil; TblPais.FieldValues[Nome] := Brasil; FILTER Essa propriedade definida como uma varivel do tipo string, e permite que se estabelea uma condio (filtro) a ser atendida pelos registros da tabela acessada por esse componente. Para que essa condio seja aplicada, deve-se, no entanto, definir como True o valor da propriedade Filtered do componente. FILTERED Essa propriedade definida como uma varivel booleana, e define se os registros provenientes da tabela representada pelo componente devem ou no atender a uma condio (filtro) especificada na sua propriedade Filter (definida anteriormente) ou por um cdigo inserido no procedimento associado ao seu evento OnFilterRecord. FILTEROPTIONS Essa propriedade definida como uma varivel do tipo TFilterOptions que , por sua vez, um conjunto de elementos do tipo TFilterOption, sendo esses elementos definidos da seguinte maneira: foCaseInsensitive: No diferencia letras maisculas e minsculas na aplicao do filtro. foNoPartialCompare: No permite que se utilize um asterisco para definir comparaes parciais na aplicao de um filtro. Esse elemento deve ser includo quando se quer tratar o asterisco (*) como um caractere do filtro. Inicialmente, essa propriedade definida como um conjunto vazio, isto , por default nenhuma das condies anteriores especificada. RecNo

Essa propriedade definida como uma varivel inteira, e define o nmero do registro corrente, dentre todos os registros provenientes da tabela representada pelo componente. uma propriedade apenas de leitura, e no pode ter o seu valor diretamente alterado pelo usurio, podendo ter o seu valor alterado em funo da aplicao de um filtro. RECORDCOUNT Essa propriedade definida como uma varivel inteira, e define o nmero de registros provenientes da tabela representada pelo componente. uma propriedade apenas de leitura, e no pode ter o seu valor diretamente alterado pelo usurio, podendo, no entanto, ter o seu valor alterado em funo da aplicao de um filtro. STATE Essa propriedade uma varivel do tipo TDataSetState que define os estados que podem ser assumidos por uma tabela representada pelo componente. Essa propriedade s est disponvel durante a execuo do aplicativo, e, por ser uma propriedade apenas de leitura, no pode ter o seu valor diretamente alterado pelo usurio. Essa propriedade pode assumir um dos valores descritos a seguir: dsInactive: A tabela est inativa, ou seja, sua propriedade Active igual a false. dsBrowse: A tabela est sendo consultada. Os registros podem ser visualizados, mas no podem ser alterados. dsEdit: A tabela est sendo editada. dsFilter: O procedimento associado ao evento OnFilterRecord est sendo executado. dsInsert: A tabela est em modo de Insero (um novo registro foi includo na tabela). dsSetKey: A tabela est sendo reindexada (aplica-se apenas a objetos da classe TTable, derivada por herana da classe TDataSet). dsCalcFields: O procedimento associado ao evento OnCalcFields est sendo executado. dsNewValue: Estado temporrio, utilizado para indicar que a propriedade NewValue de um objeto da classe TField est sendo acessada. dsOldValue: Estado temporrio, utilizado para indicar que a propriedade OldValue de um objeto da classe TField est sendo acessada. dsCurValue: Estado temporrio, utilizado para indicar que a propriedade CurValue de um objeto da classe TField est sendo acessada. PRINCIPAIS MTODOS DA CLASSE TDATASET Apresenta-se a seguir os principais mtodos da classe TDataset, sendo a maioria desses mtodos virtuais ou abstratos (implementados nas classes derivadas). APPEND Declarao procedure Append; Esse mtodo adiciona um novo registro aps o ltimo registro existente na tabela representada pelo componente. APPENDRECORD Declarao procedure AppendRecord(const Values: array of const); Esse mtodo adiciona e grava um novo registro aps o ltimo registro existente na tabela representada pelo componente, atribuindo aos campos do registro valores passados como parmetros na chamada do mtodo. CANCEL Declarao procedure Cancel; Esse mtodo cancela as alteraes realizadas no registro corrente da tabela representada pelo componente, desde a ltima chamada ao seu mtodo Post. CLEARFIELDS Declarao

procedure ClearFields; Esse mtodo apaga os valores armazenados nos campos do registro corrente da tabela representada pelo componente, desde que a tabela esteja em modo de edio ou insero, gerando uma exceo em caso contrrio. CLOSE Declarao procedure Close; Esse mtodo desfaz a conexo tabela representada pelo componente, atribuindo o valor False propriedade Active do componente, como mostra o trecho de cdigo a seguir, extrado da unit db.pas. procedure TDataSet.Close; begin Active := False; end; CREATE Declarao constructor Create(AOwner: TComponent); Esse o mtodo construtor da classe, e recebe como parmetro um objeto da classe TComponent, que indica o seu componente proprietrio. DELETE Declarao procedure Delete; Esse mtodo remove o registro corrente da tabela representada pelo componente, definindo o prximo registro como registro atual. DESTROY Declarao destructor Destroy;

Esse o mtodo destrutor da classe, devendo ser utilizado apenas quando uma instncia da classe criada dinamicamente pelo cdigo da aplicao (mediante uma chamada ao mtodo Create do componente que representa a tabela). DISABLECONTROLS Declarao procedure DisableControls; Esse mtodo desconecta temporariamente todos os componentes associados ao componente que representa a tabela. EDIT Declarao procedure Edit; Esse mtodo coloca a tabela representada pelo componente em modo de edio, permitindo que se alterem os valores armazenados nos campos do registro corrente. ENABLECONTROLS Declarao procedure EnableControls; Esse mtodo restabelece a conexo a todos os componentes associados ao componente que representa a tabela, cuja conexo tenha sido desabilitada por uma chamada ao mtodo DisableControls. FIELDBYNAME Declarao function FieldByName(const FieldName: string): TField;

Esse mtodo retorna um objeto da classe TField que representa o campo cujo nome passado como parmetro na chamada ao mtodo. O valor retornado pelo mtodo pode, evidentemente, ser tratado como um objeto da classe TField, e as propriedades de converso descritas anteriormente podem ser utilizadas normalmente. A utilizao desse mtodo apresenta, em relao propriedade Fields, a vantagem de se poder desconsiderar a ordem exata dos campos, bastando que se conhea o nome de cada um deles. FINDFIELD Declarao function FindField(const FieldName: string): TField; Esse mtodo determina se o componente acessa um campo cujo nome passado como parmetro na forma de uma string, retornando um objeto da classe TField que representa o campo, caso o mesmo exista, e retornando nil em caso contrrio. FIRST Declarao procedure First; Esse mtodo define o primeiro registro da tabela representada pelo componente como registro corrente. Alm disso, antes de alterar o registro corrente, grava qualquer alterao pendente, mediante uma chamada implcita ao mtodo Post do componente. INSERT Declarao procedure Insert; Esse mtodo insere um novo registro na posio definida pelo registro corrente. INSERTRECORD Declarao procedure InsertRecord(const Values: array of const); Esse mtodo insere e grava um novo registro na posio definida pelo registro corrente da tabela representada pelo componente, atribuindo aos campos do registro valores passados como parmetros na chamada do mtodo. ISEMPTY Declarao function IsEmpty: Boolean; Esse mtodo retorna True se a tabela representada pelo componente no tiver nenhum registro, retornando False em caso contrrio. ISLINKEDTO Declarao function IsLinkedTo(DataSource: TDataSource): Boolean; Esse mtodo retorna True se o componente que representa a tabela estiver ligado a um componente DataSource, cujo nome passado como parmetro na chamada ao mtodo, retornando False em caso contrrio. LAST Declarao procedure Last; Esse mtodo define o ltimo registro da tabela representada pelo componente como registro corrente. Alm disso, antes de alterar o registro corrente, grava qualquer alterao pendente, mediante uma chamada implcita ao mtodo Post do componente. LOCATE Declarao function Locate(const KeyFields: string; const KeyValues: Variant; Options: TLocateOptions): Boolean; Esse mtodo permite a busca exata de um registro, por campos que no faam parte do ndice corrente

da tabela representada pelo componente, e recebe como parmetros: Uma string contendo os nomes dos campos pelos quais ser feita a pesquisa (separados por ponto-e-vrgula). Uma string contendo os valores a serem pesquisados nos campos pelos quais ser feita a pesquisa (separados por ponto-e-vrgula). Um conjunto de opes, que pode conter os seguintes elementos: LoCaseInsensitive se esse elemento for includo, letras maisculas e minsculas sero tratadas indiferentemente; LoPartialKey indica que a pesquisa ser aproximada. MOVEBY Declarao function MoveBy(Distance: Integer): Integer; Esse mtodo redefine o registro atual, deslocando o ponteiro ou cursor que representa o registro atual da tabela representada pelo componente por um nmero de registros que passado como nico parmetro na chamada do mtodo. NEXT Declarao procedure Next; Esse mtodo define o prximo registro da tabela representada pelo componente como registro corrente. Alm disso, antes de alterar o registro corrente, grava qualquer alterao pendente, mediante uma chamada implcita ao mtodo Post do componente. Na realidade, esse mtodo faz uma chamada ao mtodo MoveBy da classe, passando o valor 1 como parmetro, como mostra o trecho de cdigo reproduzido a seguir e extrado da unit db.pas. procedure TDataSet.Next; begin MoveBy(1); end; OPEN Declarao procedure Open; Esse mtodo estabelece a conexo tabela representada pelo componente, atribuindo o valor True sua propriedade Active, como mostra o trecho de cdigo a seguir, extrado da unit db.pas. procedure TDataSet.Open; begin Active := True; end; POST Declarao procedure Post; Esse mtodo grava as alteraes feitas no registro atual da tabela representada pelo componente. As alteraes feitas anteriormente a uma chamada ao mtodo Post no podem ser canceladas mediante uma chamada ao mtodo Cancel (para que isso seja possvel, deve-se empregar o conceito de transaes, a ser descrito posteriormente). PRIOR Declarao procedure Prior; Esse mtodo define o registro anterior da tabela representada pelo componente como registro corrente. Alm disso, antes de alterar o registro corrente, grava qualquer alterao pendente, mediante uma chamada implcita ao mtodo Post do componente. Na realidade, esse mtodo faz uma chamada ao mtodo MoveBy da classe, passando o valor -1 como parmetro, como mostra o trecho de cdigo a seguir, extrado da unit db.pas. procedure TDataSet.Prior; begin

MoveBy(-1); end; REFRESH Declarao procedure Refresh; Esse mtodo atualiza a exibio dos dados armazenados em uma tabela nos componentes de visualizao conectados ao componente que representa a tabela. Uma situao em que deve ser feita uma chamada ao mtodo refresh do componente corresponde quela em que a aplicao de um filtro cancelada (modificando-se o valor da sua propriedade Filtered para False). SETFIELDS Declarao procedure SetFields(const Values: array of const); Esse mtodo permite que se atribuam simultaneamente valores a vrios campos do registro corrente da tabela representada pelo componente. Os valores devem ser fornecidos na ordem em que os campos so armazenados na tabela. Para executar esse mtodo a tabela deve estar em modo de edio, o que pode ser garantido por uma chamada ao mtodo Edit do componente que a representa.

PRINCIPAIS EVENTOS DA CLASSE TDATASET

Apresenta-se a seguir uma descrio dos principais eventos da classe TDataSet. AFTERCANCEL O procedimento associado a esse evento executado imediatamente aps se cancelarem as alteraes feitas no registro corrente, normalmente aps uma chamada ao mtodo Cancel do componente que representa a tabela. Na realidade, o mtodo Cancel faz uma chamada a um mtodo protegido da classe TDataSet, denominado DoAfterCancel, que verifica se existe um procedimento associado ao evento e, em caso positivo, o executa. AFTERCLOSE O procedimento associado a esse evento executado imediatamente aps se interromper a conexo estabelecida entre a tabela e o componente que a representa, normalmente aps uma chamada ao seu mtodo Close, ou atribuindo-se o valor False sua propriedade Active. Na realidade, o mtodo Close, ao atribuir o valor False propriedade Active, provoca uma chamada a um mtodo protegido da classe TDataSet, denominado DoAfterClose, que verifica se existe um procedimento associado ao evento e, em caso positivo, o executa. O mesmo feito pelo mtodo interno SetActive, responsvel pela atribuio de um valor ao campo que armazena internamente o valor da propriedade Active. AFTERDELETE O procedimento associado a esse evento executado imediatamente aps se remover o registro corrente, normalmente aps uma chamada ao mtodo Delete do componente que representa a tabela. Na realidade, o mtodo Delete faz uma chamada a um mtodo protegido da classe TDataSet, denominado DoAfterDelete, que verifica se existe um procedimento associado ao evento e, em caso positivo, o executa. AFTEREDIT O procedimento associado a esse evento executado imediatamente aps se colocar a tabela representada pelo componente em modo de edio. Na realidade, o mtodo Edit faz uma chamada a um mtodo protegido da classe TDataSet, denominado DoAfterEdit, que verifica se existe um procedimento associado ao evento e, em caso positivo, o executa. AFTERINSERTT

O procedimento associado a esse evento executado imediatamente aps a insero de um novo registro na tabela representada pelo componente. Na realidade, os mtodos Insert e Append fazem uma chamada a um mtodo protegido da classe TDataSet, denominado DoAfterInsertt, que verifica se existe um procedimento associado a esse evento e, em caso positivo, o executa. AFTEROPEN O procedimento associado a esse evento executado imediatamente aps se estabelecer a conexo entre a tabela e o componente que a representa, normalmente aps uma chamada ao seu mtodo Open, ou atribuindo-se o valor True sua propriedade Active. Na realidade, o mtodo Open, ao atribuir o valor True propriedade Active, faz uma chamada a um mtodo protegido da classe TDataSet, denominado DoAfterOpen, que verifica se existe um procedimento associado ao evento e, em caso positivo, o executa. O mesmo feito pelo mtodo interno SetActive, responsvel pela atribuio de um valor ao campo que armazena internamente o valor da propriedade Active. AFTERPOST O procedimento associado a esse evento executado imediatamente aps a gravao das alteraes feitas no registro corrente da tabela representada pelo componente, normalmente aps uma chamada ao seu mtodo Post. Na realidade, o mtodo Post faz uma chamada a um mtodo protegido da classe TDataSet, denominado DoAfterPost, que verifica se existe um procedimento associado ao evento e, em caso positivo, o executa. AFTERSCROLL O procedimento associado a esse evento executado imediatamente aps uma movimentao para um outro registro da tabela (que passa a ser o registro corrente), normalmente aps uma chamada aos seus mtodos First, Prior, Next e Last, dentre outros. Na realidade, esses mtodos fazem uma chamada a um mtodo protegido da classe TDataSet, denominado DoAfterScroll, que verifica se existe um procedimento associado ao evento e, em caso positivo, o executa. BEFORECANCEL O procedimento associado a esse evento executado imediatamente antes de se cancelarem as alteraes feitas no registro corrente, normalmente aps uma chamada ao mtodo Cancel do componente que representa a tabela. Na realidade, o mtodo Cancel faz uma chamada a um mtodo protegido da classe TDataSet, denominado DoBeforeCancel, que verifica se existe um procedimento associado ao evento e, em caso positivo, o executa. BEFORECLOSE O procedimento associado a esse evento executado imediatamente antes de se interromper a conexo estabelecida entre a tabela e o componente que a representa, normalmente aps uma chamada ao seu mtodo Close, ou atribuindo-se o valor False sua propriedade Active. Na realidade, o mtodo Close faz uma chamada a um mtodo protegido da classe TDataSet, denominado DoBeforeClose, que verifica se existe um procedimento associado ao evento e, em caso positivo, o executa. O mesmo feito pelo mtodo interno SetActive, responsvel pela atribuio de um valor ao campo que armazena internamente o valor da propriedade Active. BEFOREDELETE O procedimento associado a esse evento executado imediatamente antes de se remover o registro corrente, normalmente aps uma chamada ao mtodo Delete do componente que representa a tabela. Na realidade, o mtodo Delete faz uma chamada a um mtodo protegido da classe TDataSet, denominado DoBeforeDelete, que verifica se existe um procedimento associado ao evento e, em caso positivo, o executa. BEFOREEDIT O procedimento associado a esse evento executado imediatamente antes de se colocar a tabela representada pelo componente em modo de edio. Na realidade, o mtodo Edit faz uma chamada a um mtodo protegido da classe TDataSet, denominado

DoBeforeEdit, que verifica se existe um procedimento associado ao evento e, em caso positivo, o executa. BEFOREINSERT O procedimento associado a esse evento executado imediatamente antes da insero de um novo registro na tabela representada pelo componente. Na realidade, os mtodos Insert e Append fazem uma chamada a um mtodo protegido da classe TDataSet, denominado DoBeforeInsertt, que verifica se existe um procedimento associado ao evento e, em caso positivo, o executa. BEFOREOPEN O procedimento associado a esse evento executado imediatamente antes de se estabelecer a conexo entre a tabela e o componente que a representa, normalmente aps uma chamada ao seu mtodo Open, ou atribuindo-se o valor True sua propriedade Active. Na realidade, o mtodo Open faz uma chamada a um mtodo protegido da classe TDataSet, denominado DoBeforeOpen, que verifica se existe um procedimento associado ao evento e, em caso positivo, o executa. O mesmo feito pelo mtodo interno SetActive, responsvel pela atribuio de um valor ao campo que armazena internamente o valor da propriedade Active. BEFOREPOST O procedimento associado a esse evento executado imediatamente antes da gravao das alteraes feitas no registro corrente da tabela representada pelo componente, normalmente aps uma chamada ao seu mtodo Post. Na realidade, o mtodo Post faz uma chamada a um mtodo protegido da classe TDataSet, denominado DoBeforePost, que verifica se existe um procedimento associado ao evento e, em caso positivo, o executa. BEFORESCROLL O procedimento associado a esse evento executado imediatamente antes de uma movimentao para um outro registro da tabela (que passa a ser o registro corrente), normalmente aps uma chamada aos seus mtodos First, Prior, Next e Last, dentre outros. Na realidade, esses mtodos fazem uma chamada a um mtodo protegido da classe TDataSet, denominado DoBeforeScroll, que verifica se existe um procedimento associado ao evento e, em caso positivo, o executa. ONCALCFIELDS O procedimento associado a esse evento executado sempre que os valores dos campos calculados da tabela representada pelo componente precisam ser calculados. ONDELETEERROR O procedimento associado a esse evento executado sempre que a tentativa de se remover um registro da tabela, em uma chamada ao seu mtodo Delete, falha. ONFILTERRECORD O procedimento associado a esse evento executado sempre que se aplica um filtro aos registros da tabela, devendo nesse procedimento ser estabelecida a condio a ser atendida pelos registros. A aplicao de um filtro a uma tabela pode ser feita atribuindo-se o valor True sua propriedade Filtered. ONNEWRECORD O procedimento associado a esse evento executado sempre que se adiciona um novo registro tabela representada pelo componente, mediante uma chamada ao mtodo Append ou Insert, podendo ser utilizado para se definir valores default para os campos do registro recm-criado. ONPOSTERROR O procedimento associado a esse evento executado sempre que a tentativa de se gravar um registro da tabela, em uma chamada ao seu mtodo Post, falha. Conforme ser visto nos prximos captulos, as classes de acesso a dados via BDE, DbExpress e Interbase Express no so derivadas diretamente da classe TDataSet, mas de outras classes dela derivadas, e que so: TBDEDataSet e TDBDataset, para acesso via BDE.

 TIBCustomDataset, para acesso via Interbase Express. TCustomSQLDataSet, para acesso via DbExpress. A classes TClientDataset e TSQLClientDataset so derivadas diretamente da classe TCustomClientDataset.

A CLASSE TCUSTOMCONNECTION
A classe TCustomConnection a classe-base das classes usadas para fazer uma conexo a uma fonte de dados remota (banco de dados) de praticamente todas as tecnologias de acesso a banco de dados, excluindo o BDP Borland Data Provider: o BDE (componente TDatabase), InterbaseExpress (TIBDatabase) e DbExpress (TSQLConnection). Portanto, essa classe possui claro destaque, justificando o estudo a seguir.

PRINCIPAIS PROPRIEDADES DA CLASSE TCUSTOMCONNECTION

Apresenta-se a seguir uma descrio das principais propriedades da classe TCustomConnection, alm daquelas herdadas das suas classes ancestrais. CONNECTED Essa propriedade definida como uma varivel booleana e define se a conexo foi estabelecida. DATASETCOUNT Essa propriedade definida como uma varivel inteira e define o nmero de componentes derivados da clase TDataset linkados a este componente de conexo. DATASETS Essa propriedade uma array de objetos de classes derivadas da classe TDataset, e permite acessar os componentes linkados a este componente de conexo. LOGINPROMPT Essa propriedade definida como uma varivel booleana e define se uma caixa de dilogo dever ser exibida quando se estabelece uma conexo. STREAMEDCONNECTED Essa propriedade definida como uma varivel booleana e define se a conexo estava ativa quando o componente responsvel pela conexo foi carregado a partir de um stream.

PRINCIPAIS MTODOS DA CLASSE TCUSTOMCONNECTION

Apresenta-se a seguir uma descrio dos principais mtodos da classe TCustomConnection, alm daqueles herdados das suas classes ancestrais. CLOSE Declarao procedure Close; Esse mtodo encerra uma conexo (equivale a definir a propriedade Connected como False). DOCONNECT Declarao procedure DoConnect; Esse mtodo estabelece a conexo ao banco de dados (usado pela propriedade connected para estabelecer a conexo). DODISCONNECT Declarao procedure DoDisConnect; Esse mtodo finaliza a conexo ao banco de dados (usado pela propriedade comnected para finalizar a conexo).

GETCONNECTED Declarao function GetConnected: Boolean; Esse mtodo retorna o valor armazenado na propriedade Connected. GETDATASET Declarao function GetDataSet(Index:Integer): TDataSet; Esse mtodo retorna uma referncia a um dos objetos derivados da classe TDataset vinculados a esta conexo, recebendo como parmetro o ndice que define o objeto na propriedade Datasets. GETDATASETCOUNT Declarao function GetDataSetCount: Integer; Esse mtodo retorna o valor armazenado na propriedade DatasetCount. LOADED Declarao procedure Loaded; Esse mtodo carrega o componente de conexo aps todos os outros componentes do formulrio ou Datamodule terem sido carregados na memria. OPEN Declarao procedure Open; Esse mtodo inicializa ou estabelece uma conexo. SETCONNECTED Declarao procedure SetConnected(Value: Boolean); virtual; Esse mtodo altera o valor da propriedade Connected, em funo do argumento passado como parmetro na chamada do mtodo.

PRINCIPAIS EVENTOS DA CLASSE TCUSTOMCONNECTION

Apresenta-se a seguir uma descrio dos principais mtodos da classe TCustomConnection, alm daqueles herdados das suas classes ancestrais. AFTERCONNECT Esse evento ocorre assim que uma conexo estabelecida. AFTERDISCONNECT Esse evento ocorre assim que uma conexo encerrada. BEFORECONNECT Esse evento ocorre antes que uma conexo seja estabelecida. BEFOREDISCONNECT Esse evento ocorre antes que uma conexo seja encerrada. ONLOGIN O procedimento associado a esse evento executado sempre que se estabelece uma nova conexo ao banco de dados representado pelo componente, e o valor da sua propriedade LoginPrompt igual a True. Esse procedimento tem, entre seus parmetros, um objeto da classe TStrings chamado LogimParams no qual devem ser fornecidos os valores dos parmetros USERNAME e PASSWORD, para permitir o acesso ao banco de dados. Caso se esteja utilizando a caixa de dilogo padro de Login, no h necessidade de se codificar esse procedimento.