Acesso Clientes

Número Azul Das 8 às 22 horas 808 78 1000

Guias de utilização

Aproveite os serviços da arsys.pt ao máximo

Ajuda

Pesquisa de temas de ajuda



Componentes ActiveX

AspGrid

Encontra-se instalado para os planos de alojamento sob plataforma Windows Plano Empresarial, Plano Master, Plano Master Plus e Plano ISP, o componente de servidor AspGrid com licença em versão 3.1, que oferece às suas aplicações ASP a possibilidade de utilizar um controlo de tipo grelha para gerir os registos das suas bases de dados.

Este componente permitir-lhe-á criar interfaces de acesso às suas bases de dados, independentes do navegador, com apenas 3 linhas de código.

Como utilizar AspGrid

A utilização do AspGrid sob ASP requer uns passos básicos, que vamos relatar com o seguinte exemplo de código (que deverá adaptar às suas necessidades na sua página asp):

<%

' Atribuímos o string da ligação
strConnect = "DSN=dsn.dominio.com"

' Criamos uma instância do objecto grelha
Set Grid = Server.CreateObject("Persits.Grid")

' Conectamos o objecto com a base de dados
Grid.Connect strConnect, "", ""

' Especificamos a consulta sobre a base de dados
Grid.SQL = "select id, nome, telefone from departamentos"

' Ocultamos a coluna id
Grid.Cols("id").Hidden = True

' Especificamos a localização das imagens do botão
Grid.ImagePath = "../imagens/"

' Mostramos a grelha
Grid.Display

' Desligamos da base de dados
Grid.Disconnect

' Eliminamos o objecto
Set Grid = Nothing

%>

Trata-se basicamente de:

  • Abrir una ligação com a base de dados.
  • Criar o objecto grelha.
  • Conectar o objecto à ligação estabelecida.
  • Especificar a consulta à base de dados.
  • Visualizar a grelha.
  • Fechar a ligação e eliminar o objecto.

Observemos o exemplo passo por passo:

A primeira sentença estabelece o string de ligação, necessário para conectar à base de dados (bem seja Access ou SQL), através do DSN:

strConnect = "DSN=dsn.dominio.com"

Também pode se utilizar a cadeia completa como string de ligação, especificando o driver e rota no disco da base de dados. Por exemplo:

strConnect = "DRIVER={Microsoft Access Driver (*.mdb)};DBQ=" &_
Server.MapPath("..\db\aspgrid.mdb")

No caso de utilizar o sistema anterior, se quisermos conectar a uma base de dados SQL, devemos modificar o string de ligação de forma semelhante a:

strConnect ="Provider=SQLOLEDB; Server=nomedoservidorsql; Database=nomedabasededados; UID=utilizador; PWD=password"

Posteriormente criamos o objecto grelha:

Set Grid = Server.CreateObject("Persits.Grid")

A linha

Grid.Connect strConnect, "", ""

indica ao objecto grelha que se conecte com a base de dados especificada no string de ligação. Como já assinalamos:

  • o primeiro argumento pode ser um DSN do sistema ou uma cadeia de ligação sem DSN onde se indicam todos os parâmetros para o acesso.
  • O segundo e terceiro argumentos permitem especificar um utilizador e password no caso de que a sua base de dados requeira autentificação.
  • Considere que também pode passar estes dados através do string de ligação, mediante os atributos "UID=utilizador; PWD=password"

A linha

Grid.SQL = "select id, nome, telefone from departamentos"

especifica a sentença SQL na qual a grelha basear-se-á. Para que a mesma seja editável, deve de estar baseada numa tabela que contenha uma coluna com um campo auto-numérico (IDENTITY column), e esta coluna deve aparecer em primeiro lugar na sentença.

No exemplo, é a chave "id". Se esta coluna não existir, deverá cria-la na sua base de dados. Isto não lhe afectará nas chaves primárias existentes nem nas relações de entidade que já tivesse.

A linha

Grid.Cols("id").Hidden = True

oculta a coluna ("id"). É importante que oculte sempre o campo auto-numérico ou, ao menos, o crie para só leitura para que a funcionalidade de inserção de registos não se veja prejudicada. O método aceita além do nome, a referencia numérica a posição do campo dentro da consulta SQL. No nosso caso, o campo "id" é o primeiro, pelo que a sentença seria equivalente a:

Grid.Cols(1).Hidden = True

A linha seguinte

Grid.ImagePath = "../imagens/"

especifica a localização relativa das imagens dos botões de controlo, que utiliza o objecto para realizar acções sobre os registos -como eliminar, anexar, modificar,..-. Se optar por colocar as imagens na mesma directoria que o seu ficheiro asp, não será necessário utilizar esta propriedade.

A sentença

Grid.Display

mostra o objecto e permite a sua utilização. É a sentença que habilita o objecto para a manipulação dos registos e que oferece toda a funcionalidade ao mesmo.

Finalmente as líneas de código

Grid.Disconnect

Set Grid = Nothing

fecham a ligação à base de dados e eliminam o objecto.

Algumas características

A nossa versão do componente AspGrid inclui as seguintes características:

  • Permite criar uma interface tipo grelha editável e baseada em páginas web que enlace a uma tabela numa base de dados com apenas 3 linhas de código ASP.
  • Interface de objectos intuitiva que lhe permite personalizar a aparência dos dados na grelha.
  • Suporta recordsets com chaves estrangeiras (foreign-keys recordsets).
  • Suporta controlos HTML caixas combinadas (list box,combo box), caixas de opção (checkboxes) e quadros de texto (textareas).
  • Permite transformar campos de dados em vínculos ou imagens.
  • Suporta ordenação por colunas.
  • Botões de navegação.
  • Suporta formulários de dados enlaçados.

Além disto, esta versão oferece algumas melhoras em relação à versão anterior:

  • Suporta a gestão de vários registos simultaneamente (editar, salvar ou eliminar).
  • Suporta calendários emergentes baseados em JavaScript.
  • Suporte ADO. Permite a utilização de objectos externos Recordset e Connection.
  • Suporte completo para validação JavaScript do lado do cliente.
  • Botões de navegação ("Top" e "Bottom").

Pode encontrar mais informação ao respeito das características do produto, assim como exemplos, no site do AspGrid.

Voltar à ajuda

* Os preços não incluem IVA.