Exibir registros de banco de dados

Última atualização em 25/04/2024
Nota

A interface de usuário foi simplificada no Dreamweaver 2017. Logo, talvez você não consiga encontrar algumas das opções descritas neste artigo no Dreamweaver 2017 e em versões posteriores. Para obter mais informações, consulte este artigo (em inglês).

Sobre os registros do banco de dados

A exibição de registros do banco de dados envolve recuperar informações armazenadas em um banco de dados ou outra fonte de conteúdo e renderizar essas informações em uma página da Web. O Dreamweaver oferece vários métodos para exibir conteúdo dinâmico e fornece diversos comportamentos de servidor integrados que permitem aprimorar a apresentação do conteúdo dinâmico e permitir que os usuários pesquisem com mais facilidade e naveguem pelas informações retornadas de um banco de dados.

Bancos de dados e outras fontes de conteúdo dinâmico oferecem mais poder e flexibilidade na pesquisa, classificação e visualização de grandes repositórios de informações.Usar um banco de dados para armazenar conteúdo para sites faz sentido quando você precisa armazenar grandes quantidades de informações e depois recuperar e exibir essas informações de forma significativa. O Dreamweaver oferece várias Ferramentas e comportamentos predefinidos para ajudar você a recuperar e exibir com eficácia informações armazenadas em um banco de dados.

Comportamentos de servidor e elementos de formatação

O Dreamweaver oferece os seguintes comportamentos de servidor e elementos de formatação para permitir que você aprimore a exibição de dados dinâmicos:

Formatos

permitem aplicar diferentes tipos de valores numéricos, monetários, de data/hora e de porcentagem ao texto dinâmico.

Por exemplo, se o preço de um item em um conjunto de registros for 10.989, você pode exibir o preço na página como $10,99 selecionando o formato "Moeda - 2 casas decimais" do Dreamweaver. Esse formato exibe um número usando duas casas decimais. Se o número tiver mais de duas casas decimais, o formato de dados arredonda o número para o decimal mais próximo. Se o número não tiver casas decimais, o formato de dados adiciona um ponto decimal e dois zeros.

Região repetitiva

os comportamentos de servidor permitem exibir vários itens retornados de uma consulta de banco de dados e especificar o número de registros a serem exibidos por página.

Navegação do conjunto de registros

os comportamentos de servidor permitem inserir elementos de navegação que permitem aos usuários passar para o próximo conjunto de registros ou o anterior retornado pelo conjunto de registros. Por exemplo, se você optar por exibir 10 registros por página usando o objeto de servidor Região de repetição e o conjunto de registros retornar 40 registros, você pode navegar por 10 registros por vez.

Barra de status Conjunto de registros

os comportamentos de servidor permitem incluir um contador que mostra aos usuários onde eles estão em um conjunto de registros em relação ao número total de registros retornados.

Mostrar região

os comportamentos de servidor permitem escolher mostrar ou ocultar itens na página com base na relevância dos registros exibidos atualmente. Por exemplo, se um usuário tiver navegado para o último registro em um conjunto de registros, você pode ocultar o link Próximo e exibir apenas o link de registros Anterior.

Aplicar elementos tipográficos e de layout de página a dados dinâmicos

Um recurso poderoso do Dreamweaver é a capacidade de apresentar dados dinâmicos dentro de uma página estruturada e aplicar formatação tipográfica usando HTML e CSS. Para aplicar formatos a dados dinâmicos no Dreamweaver, formate as tabelas e espaços reservados para os dados dinâmicos usando as ferramentas de formatação do Dreamweaver.Quando os dados são inseridos da fonte de dados, eles adotam automaticamente a formatação de fonte, parágrafo e tabela que você especificou.

Os links de navegação de conjunto de registros permitem que os usuários passem de um registro para o próximo ou de um conjunto de registros para o próximo. Por exemplo, depois de criar uma página para exibir cinco registros por vez, você pode querer adicionar links como Próximo ou Anterior que permitem aos usuários exibir os cinco registros seguintes ou anteriores.

Você pode criar quatro tipos de links de navegação para percorrer um conjunto de registros: Primeiro, Anterior, Próximo e Último. Uma página única pode conter qualquer número desses links, desde que todos funcionem em um único conjunto de registros. Não é possível adicionar links para navegar por um segundo conjunto de registros na mesma página.

Os links para navegação no conjunto de registros exigem os seguintes elementos dinâmicos:

  • Um conjunto de registros para navegação

  • Conteúdo dinâmico na página para exibir o(s) registro(s)

  • Texto ou imagens na página que servem como uma barra de navegação clicável

  • Um conjunto de comportamentos de servidor Mover Para Registro para navegar pelo conjunto de registros

    É possível adicionar os dois últimos elementos usando o objeto de servidor Barra de Navegação de Registros, ou adicioná-los separadamente usando as ferramentas de design e o painel Comportamentos do Servidor.

Criar uma barra de navegação do conjunto de registros

É possível criar uma barra de navegação de conjunto de registros em uma única operação usando o comportamento de servidor Barra de Navegação de Conjunto de Registros. O objeto de servidor adiciona os seguintes blocos de construção à página:

  • Uma tabela em HTML com links de texto ou imagem

  • Um conjunto de comportamentos de servidor Mover para

  • Um conjunto de comportamentos de servidor Mostrar região

    A versão em texto de Barra de navegação do conjunto de registros é semelhante a:

Versão em texto de Barra de navegação do conjunto de registros

Barra de navegação do conjunto de registros

Antes de colocar a barra de navegação na página, verifique se a página contém um conjunto de registros para navegação e um layout de página no qual exibir os registros.

Depois de colocar a barra de navegação na página, você pode usar as ferramentas de design para personalizar a barra. Você também pode editar os comportamentos de servidor Mover para e Mostrar região clicando duas vezes neles no painel Comportamentos de servidor.

O Dreamweaver cria uma tabela que contém links de texto ou de imagem que permitem ao usuário navegar no conjunto de registros selecionado quando clicado. Quando o primeiro registro do conjunto é exibido, os links Primeiro e Anterior ou as imagens permanecem ocultos. Quando o último registro do conjunto é exibido, os links Próximo e Último ou as imagens permanecem ocultos.

Você pode personalizar o layout da barra de navegação usando as ferramentas de design e o painel Comportamentos de servidor.

Na visualização Design, coloque o ponto de inserção no local da página onde deseja que a barra de navegação apareça.
Exibir a caixa de diálogo Barra de Navegação de Conjunto de Registros (Inserir > Objetos de Dados > Paginação de Conjunto de Registros > Barra de Navegação de Conjunto de Registros).
Selecione o conjunto de registros que deseja navegar no menu pop‑up Conjunto de Registros.
Na seção Exibir Usando, selecione o formato para exibir os links de navegação na página e clique em OK.

Texto

Coloca links de texto na página.

Imagens

Inclui imagens gráficas como links. Dreamweaver usa seus próprios arquivos de imagem. É possível substituir essas imagens por arquivos de imagem próprios após colocar a barra na página.

Barras de navegação do conjunto de registros personalizadas

É possível criar sua própria barra de navegação de conjunto de registros que use estilos de layout e formatação mais complexos do que a tabela simples criada pelo objeto de servidor Barra de Navegação de Conjunto de Registros.

Para criar sua própria barra de navegação do conjunto de registros, você deve:

  • Criar links de navegação em texto ou imagens

  • Colocar os links na página usando a Visualização de design

  • Atribuir comportamentos de servidor individuais a cada link de navegação

Esta seção descreve como atribuir comportamentos de servidor individuais aos links de navegação.

Na visualização Design, selecione o string de texto ou imagem na página que deseja usar como um link de navegação de registro.
Abra o painel Comportamentos do Servidor (Janela > Comportamentos do Servidor) e clique no botão Mais (+).
Selecione Paginação de Conjunto de Registros no menu pop‑up; em seguida, selecione um comportamento de servidor apropriado para esse link dos comportamentos de servidor listados.

Se o conjunto de registros contiver um grande número de registros, o comportamento de servidor Mover Para o Último Registro pode demorar muito para executar quando o usuário clicar no link.

No menu pop‑up Conjunto de Registros, selecione o conjunto de registros que contém os registros e clique em OK.

O comportamento de servidor é atribuído ao link de navegação.

Definir as opções da caixa de diálogo Mover Para (comportamento de servidor)

Adicionar links que permitem ao usuário navegar pelos registros em um conjunto de registros.

Se não selecionou nada na página, selecione um link no menu pop‑up.
Selecione o conjunto de registros que contém os registros para paginar e clique em OK.
Nota

Se o conjunto de registros contiver um grande número de registros, o comportamento de servidor Ir para último registro pode levar muito tempo para executar quando o usuário clicar no link.

Ao criar uma barra de navegação personalizada, comece criando sua representação visual usando as ferramentas de design de página do Dreamweaver.Você não precisa criar um link para a string de texto ou imagem; o Dreamweaver cria um para você.

A página para a qual você criar a barra de navegação deve conter um conjunto de registros para navegar.Uma barra de navegação de conjunto de registros simples pode ser assim, com botões de link criados a partir de imagens ou outros elementos de conteúdo:

Barra de navegação do conjunto de registros simples

Depois de adicionar um conjunto de registros a uma página e criar uma barra de navegação, você deve aplicar comportamentos de servidor individuais a cada elemento de navegação.Por exemplo, uma barra de navegação típica de conjunto de registros contém representações dos seguintes links combinados ao comportamento apropriado:

Link de navegação

Comportamento de servidor

Ir para primeira página

Mover para primeira página

Ir para página anterior

Mover para página anterior

Ir para próxima página

Mover para próxima página

Ir para última página

Mover para última página

Exibir e ocultar regiões com base nos resultados do conjunto de registros

Você também pode especificar que uma região seja exibida ou ocultada com base em o conjunto de registros estar em branco.Se um conjunto de registros estiver em branco (por exemplo, nenhum registro foi encontrado que corresponda à consulta), você pode exibir uma mensagem informando ao usuário que nenhum registro foi retornado.Isso é especialmente útil ao criar páginas de pesquisa que dependem de termos de pesquisa inseridos pelo usuário para executar consultas.Da mesma forma, você pode exibir uma mensagem de erro se houver um problema ao conectar-se a um banco de dados, ou se o nome de usuário e senha de um usuário não coincidirem com aqueles reconhecidos pelo servidor.

Os comportamentos de servidor Mostrar região são:

  • Mostrar se conjunto de registros estiver vazio

  • Mostrar se conjunto de registros não estiver vazio

  • Mostrar se for primeira página

  • Mostrar se não for primeira página

  • Mostrar se for última página

  • Mostrar se não for última página

Na visualização Design, selecione a região na página para mostrar ou ocultar.
No painel Comportamentos de servidor (Janela > Comportamentos de servidor), clique no botão Mais (+).
Selecione Mostrar região no menu pop‑up, selecione um dos comportamentos de servidor listados e clique em OK.

Exibir vários resultados do conjunto de registros

O comportamento de servidor Região repetitiva permite exibir vários registros de um conjunto de registros dentro de uma página.Qualquer seleção de conteúdo dinâmico pode ser transformada em uma região repetitiva.No entanto, as regiões mais comuns são uma tabela, uma linha de tabela ou uma série de linhas de tabela.

Na visualização Design, selecione uma região que contenha conteúdo dinâmico.

A seleção pode ser qualquer coisa, incluindo uma tabela, uma linha de tabela ou até mesmo um parágrafo de texto.

Para selecionar uma região na página com precisão, você pode usar o seletor de tag no canto esquerdo da janela do documento.Por exemplo, se a região for uma linha de tabela, clique dentro da linha na página e clique no tag <tr> mais à direita no seletor de tag para selecionar a linha de tabela.

Selecione Janela > Comportamentos de servidor para exibir o painel Comportamentos de servidor.
Clique no botão Mais (+) e selecione Região repetitiva.
Selecione o nome do conjunto de registros a ser usado no menu pop‑up.
Selecione o número de registros a serem exibidos por página e clique em OK.

Na janela do documento, um contorno cinza fino com abas aparece ao redor da região de repetição.

Modificar regiões de repetição no inspetor de propriedades

Modifique a região de repetição selecionada alterando qualquer uma das seguintes opções:
  • O nome da região repetitiva.

  • O conjunto de registros que fornece os dados para a região de repetição.

  • O número de registros exibidos

    Ao selecionar uma nova opção, o Dreamweaver atualiza a página.

Reutilizar conjuntos de registros PHP

Para um tutorial sobre como reutilizar conjuntos de registros PHP, consulte o tutorial de David Powers, Como reutilizo um conjunto de registros PHP em mais de uma região de repetição?

Criar uma tabela dinâmica

O exemplo a seguir ilustra como o comportamento de servidor Região de repetição é aplicado a uma linha de tabela e especifica que nove registros são exibidos por página.A própria linha exibe quatro registros diferentes: cidade, estado, endereço e CEP.

O comportamento de servidor Região repetitiva é aplicado a uma linha de tabela

Para criar uma tabela como a do exemplo anterior, você deve criar uma tabela que contenha conteúdo dinâmico e aplicar o comportamento de servidor Região de repetição à linha da tabela que contém o conteúdo dinâmico.Quando a página é processada pelo servidor de aplicativos, a linha é repetida o número de vezes especificado no objeto de servidor Região de Repetição, com um registro diferente inserido em cada nova linha.

Escolha uma destas opções para inserir uma tabela dinâmica:
  • Selecione Inserir > Objetos de dados > Dados dinâmicos > Tabela dinâmica para exibir a caixa de diálogo Tabela dinâmica.

  • Na categoria Dados do painel Inserir, clique no botão Dados dinâmicos e selecione o ícone Tabela dinâmica no menu pop-up.

Selecione o conjunto de registros no menu pop-up Conjunto de registros.
Selecione o número de registros a serem exibidos por página.
(Opcional) Insira valores para a borda da tabela, preenchimento de células e espaçamento entre células.

A caixa de diálogo Tabela dinâmica retém os valores inseridos para bordas da tabela, preenchimento de células e espaçamento entre células.

Nota

Se você estiver trabalhando em um projeto que requer várias tabelas dinâmicas com a mesma aparência, insira os valores do layout da tabela, o que simplifica ainda mais o desenvolvimento da página.Você pode ajustar esses valores após inserir a tabela usando o inspetor de propriedades da tabela.

Clique em OK.

Uma tabela e marcadores de posição para o conteúdo dinâmico definido em seu conjunto de registros associado são inseridos na página.

Uma tabela e alocadores de espaço para o conteúdo dinâmico em um conjunto de registros

Neste exemplo, o conjunto de registros contém quatro colunas: AUTHORID, FIRSTNAME, LASTNAME e BIO.A linha de título da tabela é preenchida com os nomes de cada coluna.Você pode editar os títulos usando qualquer texto descritivo ou substituí-los por imagens representativas.

Criar contadores de registros

Os contadores de registros fornecem aos usuários um ponto de referência quando estão navegando por um conjunto de registros.Normalmente, os contadores de registros exibem o número total de registros retornados e os registros atuais sendo visualizados.Por exemplo, se um conjunto de registros retorna 40 registros individuais e 8 registros são exibidos por página, o contador de registros na primeira página indicaria "Exibindo registros 1‑8 de 40."

Antes de criar um contador de registros para uma página, você deve criar um conjunto de registros para a página, um layout de página apropriado para conter o conteúdo dinâmico e, em seguida, uma barra de navegação do conjunto de registros.

Criar contadores de registros simples

Os contadores de registros permitem que os usuários saibam onde estão dentro de um determinado conjunto de registros em relação ao número total de registros retornados.Por esse motivo, os contadores de registros são um comportamento útil que pode melhorar significativamente a usabilidade de uma página da Web.

Criar um contador de registros simples usando o objeto de servidor Recordset Navigation Status.Este objeto servidor cria uma entrada de texto na página para exibir o status do registro atual.Você pode personalizar o contador de registros usando as ferramentas de design de página do Dreamweaver.

Coloque o ponto de inserção onde deseja inserir o contador de registros.
Selecione Inserir > Objetos de dados > Exibir contagem de registros > Recordset Navigation Status, selecione o conjunto de registros no menu pop‑up Recordset e clique em OK.

O objeto servidor Recordset Navigation Status insere um contador de registros de texto que aparece de forma semelhante ao seguinte exemplo:

Quando visualizado na exibição Live, o contador aparece de forma semelhante ao seguinte exemplo:

Criar e adicionar o contador de registros à página

Na caixa de diálogo Inserir Recordset Navigation Status, selecione o conjunto de registros a ser rastreado e clique em OK.

Criar contadores de registros personalizados

Você usa comportamentos de contagem de registros individuais para criar contadores de registros personalizados.Criar um contador de registros personalizado permite que você crie um contador de registros além da tabela simples de linha única inserida pelo objeto servidor Recordset Navigation Status.Você pode organizar elementos de design de várias maneiras criativas e aplicar um comportamento de servidor apropriado a cada elemento.

Os comportamentos de servidor Record Count são:

  • Exibir número de registro inicial

  • Exibir número de registro final

  • Exibir total de registros

Antes de criar um contador de registros personalizado para uma página, você deve primeiro criar um conjunto de registros para a página, um layout de página apropriado para conter o conteúdo dinâmico e uma barra de navegação do conjunto de registros.

Este exemplo cria um contador de registros que aparece de forma semelhante ao exemplo em "Contadores de registros simples." Neste exemplo, o texto em fonte sans-serif representa os espaços reservados para contagem de registros que serão inseridos na página.O contador de registros neste exemplo aparece da seguinte forma:

Exibindo registros StartRow até EndRow de RecordSet.RecordCount.

Na exibição Design, insira o texto do contador na página.O texto pode ser o que você quiser, por exemplo:

Exibindo registros até de .

Coloque o ponto de inserção ao final da sequência de caracteres de texto.
Abra o painel Comportamentos de Servidor (Janela > Comportamentos de Servidor).
Clique no botão Mais (+) no canto superior esquerdo e clique em Exibir contagem de registros.Neste submenu, selecione Exibir Total de Registros.O comportamento Exibir Total de Registros é inserido na página e um espaço reservado é inserido onde estava o ponto de inserção. A sequência de caracteres de texto é exibida da seguinte forma:

Exibindo registros até de {Recordset1.RecordCount}.

Posicione o ponto de inserção após a palavra registros, e selecione Exibir Número de Contagem de Registro Inicial em Comportamentos do Servidor > botão Mais (+) > painel Contagem de Registros. A sequência de caracteres de texto é exibida da seguinte forma:

Exibindo registros {StartRow_Recordset1} até de {Recordset1.RecordCount}.

Agora posicione o ponto de inserção entre as palavras até e de, e selecione Exibir Número de Contagem de Registro Inicial em Comportamentos do Servidor > botão Mais (+) > painel Contagem de Registros. A sequência de caracteres de texto é exibida da seguinte forma:

Exibindo registros {StartRow_Recordset1} até {EndRow_Recordset1} de {Recordset1.RecordCount}.

Confirme se o contador funciona corretamente visualizando a página na exibição em tempo real; o contador é similar ao exemplo a seguir:

Exibindo registros 1 até 8 de 40.

Se a página de resultados tiver um link de navegação para ir para o próximo conjunto de registros, ao clicar no link, o contador de registros é atualizado para mostrar o seguinte:

Mostrando registros 9 até 16 de 40.

Usar formatos de dados predefinidos

Dreamweaver inclui vários formatos de dados predefinidos que você pode aplicar a elementos de dados dinâmicos. Os estilos de formato de dados incluem formatos de data e hora, moeda, numéricos e percentuais.

Aplicar formatos de dados a conteúdo dinâmico

Selecione o espaço reservado de conteúdo dinâmico na janela Documento.
Selecione Janela > Vínculos para exibir o painel Vínculos.
Clique no botão de seta para baixo na coluna Formato.

Caso a seta para baixo não esteja visível, expanda o painel.

No menu pop-up Formato, selecione a categoria de formato de dados desejada.

Certifique-se de que o formato de dados seja apropriado para o tipo de dados que você está formatando. Por exemplo, os formatos de moeda funcionam apenas se os dados dinâmicos consistirem em dados numéricos.Observe que você não pode aplicar mais de um formato aos mesmos dados.

Verifique se o formato foi aplicado corretamente fazendo uma prévia da página na Visualização dinâmica.

Personalizar um formato de dados

Abra uma página que contenha dados dinâmicos na Visualização de design.

Selecione os dados dinâmicos para os quais você deseja criar um formato personalizado.

O item de dados ligado cujo texto dinâmico você selecionou é realçado no painel Ligações (Janela > Ligações). O painel exibe duas colunas para o item selecionado, Ligação e Formato. Caso a coluna Formato não esteja visível, alargue o painel Ligações para mostrá-la.

No painel Vínculos, clique na seta para baixo na coluna Formato para expandir o menu suspenso de formatos de dados disponíveis.

Caso a seta para baixo não esteja visível, alargue ainda mais o painel Ligações.

Selecione Editar lista de formatos no menu pop-up.

Preencha a caixa de diálogo e clique em OK.

a.Selecione o formato da lista e clique em Editar.

b.Altere qualquer um dos seguintes parâmetros nas caixas de diálogo Moeda, Número ou Porcentagem e clique em OK.

  • O número de dígitos a serem exibidos após a casa decimal
  • Se um zero deve ser colocado antes das frações
  • Se os parênteses ou um sinal de subtração devem ser usados em valores negativos
  • Se os dígitos devem ser agrupados

c.Para excluir um formato de dados, clique no formato na lista e clique no botão Menos (-).

Criar um formato de dados (somente ASP)

Abra uma página contendo dados dinâmicos na visualização Design.

Selecione os dados dinâmicos para os quais você deseja criar um formato personalizado.

Selecione Janela > Vínculos para exibir o painel Vínculos e clique na seta para baixo na coluna Formato.Se a seta para baixo não estiver visível, expanda o painel.
Selecione Editar lista de formatos no menu pop-up.
Clique no botão de adição (+) e selecione um tipo de formato.
Defina o formato e clique em OK.
Digite um nome para o novo formato na coluna Nome e clique em OK.
Nota

Embora o Dreamweaver ofereça suporte apenas à criação de formatos de dados para páginas ASP, usuários do ColdFusion e PHP podem baixar formatos criados por outros desenvolvedores ou criar formatos de servidor e publicá-los no Dreamweaver Exchange. Para obter mais informações sobre a API de Formato de Servidor, consulte Extending Dreamweaver (Ajuda > Extending Dreamweaver > Formatos de Servidor).