No Dreamweaver, abra a página ASP que executa o comando.
Última atualização em
25 de abr de 2024
Saiba como usar comandos ASP no Dreamweaver para modificar um banco de dados e adicionar e executar um procedimento armazenado.
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 objetos de comando do ASP
Um objeto de comando ASP é um objeto de servidor que executa alguma operação em um banco de dados. O objeto pode conter qualquer instrução SQL válida, incluindo uma que retorna um conjunto de registros, ou uma que insere, atualiza ou exclui registros em um banco de dados. Um objeto de comando pode alterar a estrutura de um banco de dados se a instrução SQL adiciona ou exclui uma coluna em uma tabela. Também é possível usar um objeto de comando para executar um procedimento armazenado em um banco de dados.
Um objeto de comando pode ser reutilizável, no sentido de que o servidor de aplicativo pode reutilizar uma única versão compilada do objeto para executar o comando várias vezes. Você torna um comando reutilizável definindo a propriedade Prepared do objeto Command como true, como na seguinte instrução VBScript:
mycommand.Prepared = true
Se você sabe que o comando será executado mais do que algumas vezes, ter uma única versão compilada do objeto pode tornar as operações de banco de dados mais eficientes.
Nota
Nem todos os fornecedores de bancos de dados dão suporte a comandos prepared. Se o banco de dados não oferecer suporte, ele pode retornar um erro quando você definir esta propriedade como verdadeiro. Ele pode até ignorar a solicitação para preparar o comando e definir a propriedade Prepared como false.
Um objeto de comando é criado por scripts em uma página ASP, mas o Dreamweaver permite criar objetos de comando sem escrever uma linha de código ASP.
Usar comandos ASP para modificar um banco de dados
É possível usar o Dreamweaver para criar objetos de comando ASP que inserem, atualizam ou excluem registros em um banco de dados. Você fornece ao objeto de comando a instrução SQL ou procedimento armazenado que executa a operação no banco de dados.
Abra o painel Comportamentos de servidor (Janela > Comportamentos de servidor), clique no botão Mais (+) e selecione Comando.
Insira um nome para o comando, selecione uma conexão para
o banco de dados que contém os registros que você deseja editar e selecione
a operação de edição que você deseja que o comando execute—Inserir,
Atualizar ou Excluir.
Dreamweaver inicia a instrução SQL, com base no tipo de operação selecionada.Por exemplo, se você selecionar Inserir, a caixa de diálogo fica como o exemplo a seguir:
Conclua a instrução SQL.
Para informações sobre como escrever instruções SQL que modificam bancos de dados, consulte um manual de Transact‑SQL.
Use a área Variáveis para definir todas as variáveis SQL. Forneça o nome e o valor de tempo de execução.Especificar o tipo e o tamanho de cada variável previne ataques de injeção.
O exemplo a seguir mostra uma instrução INSERT que contém três variáveis SQL.Os valores dessas variáveis são fornecidos pelos parâmetros de URL passados para a página, conforme definido na coluna Valor de Tempo de Execução da área Variáveis.
Para obter o valor de Size, use o painel Databases no Dreamweaver.Encontre seu banco de dados no painel Bancos de dados e expanda-o.Em seguida, encontre a tabela com a qual você está trabalhando e expanda-a. A tabela lista os tamanhos dos campos. Por exemplo, poderia aparecer como ADDRESS (WChar 50).Nesse exemplo, 50 é o tamanho. Você também pode encontrar o tamanho no aplicativo de banco de dados.
Nota
Os tipos de dados numérico, booleano e data/hora sempre usam -1 como tamanho.
Para determinar o valor de tipo, consulte a seguinte tabela:
Tipo no banco de dados |
Tipo no Dreamweaver |
Tamanho |
|---|---|---|
Numérico (MS Access, MS SQL Server, MySQL) |
Duplo |
-1 |
Booleano, Sim/Não (MS Access, MS SQL Server, MySQL) |
Duplo |
-1 |
Data/hora (MS Access, MS SQL Server, MySQL) |
DBTimeStamp |
-1 |
Todos os outros tipos de campos de texto, incluindo os tipos de dados de texto MySQL char, varchar e longtext |
LongVarChar |
verificar tabela do banco de dados |
Texto (MS Access) ou nvarchar, nchar (MS SQL Server) |
VarWChar |
verificar tabela do banco de dados |
Memo (MS Access), ntext (MS SQL Server), ou campos que dão suporte a grandes quantidades de texto |
LongVarWChar |
1073741823 |
Para mais informações sobre o tipo e tamanho das variáveis SQL, consulte www.adobe.com/go/4e6b330a.
Feche a caixa de diálogo.
O Dreamweaver insere código ASP na sua página que, quando executado no servidor, cria um comando que insere, atualiza ou exclui registros no banco de dados.
Por padrão, o código define a propriedade Prepared do objeto Command como verdadeiro, o que faz com que o servidor de aplicativos reutilize uma única versão compilada do objeto sempre que o comando for executado.Para alterar essa configuração, alterne para a visualização Código e altere a propriedade Prepared para falso.
Crie uma página com um formulário HTML para que os usuários possam inserir dados do
registro. No formulário HTML, inclua três campos de texto (txtCity, txtAddress,
e txtPhone) e um botão de envio. O formulário usa o método GET
e envia os valores do campo de texto para a página que contém o
comando.
Sobre os procedimentos armazenados
Embora você possa usar comportamentos de servidor para criar páginas que modificam bancos de dados, você também pode usar objetos de manipulação de banco de dados, como procedimentos armazenados ou objetos de comando ASP, para criar as páginas.
Um procedimento armazenado é um item de banco de dados reutilizável que executa alguma operação no banco de dados. Um procedimento armazenado contém código SQL que pode, entre outras coisas, inserir, atualizar ou excluir registros. Os procedimentos armazenados também podem alterar a estrutura do próprio banco de dados. Por exemplo, você pode usar um procedimento armazenado para adicionar uma coluna de tabela ou até mesmo excluir uma tabela.
Um procedimento armazenado também pode chamar outro procedimento armazenado, bem como aceitar parâmetros de entrada e retornar múltiplos valores para o procedimento de chamada na forma de parâmetros de saída.
Um procedimento armazenado é reutilizável no sentido de que você pode reutilizar uma única versão compilada do procedimento para executar uma operação de banco de dados várias vezes.Se você souber que uma tarefa de banco de dados será executada mais de algumas vezes—ou a mesma tarefa será executada por diferentes aplicativos—usar um procedimento armazenado para executar essa tarefa pode tornar as operações de banco de dados mais eficientes.
Nota
Bancos de dados MySQL e Microsoft Access não oferecem suporte a procedimentos armazenados.
Adicionar um procedimento armazenado (ColdFusion) (CS6)
Você pode usar um procedimento armazenado para modificar um banco de dados. Um procedimento armazenado é um item de banco de dados reutilizável que executa alguma operação no banco de dados.
Antes de usar um procedimento armazenado para modificar um banco de dados, verifique se o procedimento armazenado contém SQL que modifica o banco de dados de alguma forma. Para criar e armazenar um em seu banco de dados, consulte a documentação do banco de dados e um bom manual de Transact-SQL.
No Dreamweaver, abra a página que executará o procedimento armazenado.
No painel Vínculos (Janela > Vínculos), clique no botão Mais (+) e selecione Procedimento armazenado.
No menu pop-up Fonte de dados, selecione uma conexão com o banco de dados que contém o procedimento armazenado.
Digite o nome de usuário e a senha da fonte de dados do ColdFusion.
Selecione um procedimento armazenado no menu pop-up Procedimentos.
O Dreamweaver preenche automaticamente todos os parâmetros.
Selecione um parâmetro e clique em Editar se precisar fazer alterações.
A caixa de diálogo Editar variável do procedimento armazenado é exibida. O nome da variável que você está editando é exibido na caixa Nome.
Nota
Você deve inserir valores de teste para todos os parâmetros de entrada do procedimento armazenado.
Faça as alterações conforme necessário:
Selecione uma Direção no menu pop-up. Um procedimento armazenado pode ter valores de entrada, valores de saída ou valores de entrada e saída.
Selecione um tipo de SQL no menu pop-up. Insira uma Variável de retorno, um Valor de tempo de execução e um Valor de teste.
Se o procedimento armazenado usar um parâmetro, clique no botão Mais (+) para adicionar um parâmetro de página.
Nota
Você deve inserir parâmetros de página correspondentes para cada valor de retorno de parâmetro do procedimento armazenado.Não adicione parâmetros de página a menos que haja um valor de retorno correspondente.
Clique no botão Mais (+) novamente para adicionar outro parâmetro de página, se necessário.
Selecione um parâmetro de página e clique no botão Menos (-) para excluir o parâmetro, se necessário, ou clique em Editar para fazer alterações no parâmetro.
Selecione a opção Retorna conjunto de registros nomeado e insira um nome para o conjunto de registros; se o procedimento armazenado retornar um conjunto de registros, clique no botão Teste para ver o conjunto de registros que o procedimento armazenado retorna.
O Dreamweaver executa o procedimento armazenado e exibe o conjunto de registros, se houver.
Nota
Se o procedimento armazenado retornar um conjunto de registros e usar parâmetros, você deve inserir um valor na coluna Valor padrão na caixa Variáveis para testar o procedimento armazenado.
Nota
Você pode usar valores de teste diferentes para gerar conjuntos de registros diferentes. Para alterar valores de teste, clique no botão Editar para Parâmetro e altere o Valor de teste, ou clique no botão Editar para Parâmetro de página e altere o Valor padrão.
Selecione a opção Returns Status Code Named e insira um
nome para o código do status, se o procedimento armazenado retornar um Valor
de retorno de código do status. Clique em OK.
Depois de fechar a caixa, o Dreamweaver insere código ColdFusion na página que chama um procedimento armazenado no banco de dados, quando o código é executado no servidor. O procedimento armazenado por sua vez executa uma operação de banco de dados, como inserir um registro.
Se o procedimento armazenado usar parâmetros, é possível criar uma página que reúna os valores de parâmetro e os envie para a página com o procedimento armazenado. Por exemplo, é possível criar uma página que usa parâmetros de URL ou um formulário HTML para reunir valores de parâmetro dos usuários.
Executar um procedimento armazenado (ASP) (CS6)
Com páginas ASP, é necessário adicionar um objeto de comando a uma página para executar um procedimento armazenado. Para obter mais informações sobre objetos de comando, consulte Sobre objetos de comando ASP.
No Dreamweaver, abra a
página que executará o procedimento armazenado.
No painel Vínculos (Janela > Vínculos), clique no botão Mais (+) e selecione Comando (Procedimento armazenado).
A caixa de diálogo Comando é exibida.
Insira um nome para o comando, selecione uma conexão com
o banco de dados que contém o procedimento armazenado e selecione Procedimento
armazenado no menu pop-up Tipo.
Selecione o procedimento armazenado expandindo a ramificação Procedimentos
armazenados na caixa Itens do banco de dados, selecionando o procedimento
armazenado na lista e clicando no botão Procedimento.
Insira todos os parâmetros obrigatórios na tabela Variáveis.
Você não precisa inserir parâmetros para nenhuma variável RETURN_VALUE.
Clique em OK.
Depois de fechar a caixa de diálogo, o código ASP é inserido na página. Quando o código é executado no servidor, o código cria um objeto de comando que executa um procedimento armazenado no banco de dados. O procedimento armazenado por sua vez executa uma operação de banco de dados, como inserir um registro.
Por padrão, o código define a propriedade Prepared do objeto Command como true, o que faz o servidor de aplicativos reutilizar uma única versão compilada do objeto toda vez que o procedimento armazenado for executado.Se você souber que o comando será executado mais de algumas vezes, ter uma única versão compilada do objeto pode melhorar a eficiência das operações de banco de dados. No entanto, se o comando for executado apenas uma ou duas vezes, usar uma pode na verdade diminuir a velocidade do aplicativo web porque o sistema tem que pausar para compilar o comando. Para alterar a configuração, mude para a visualização Código e altere a propriedade Prepared para falso.
Nota
Nem todos os provedores de banco de dados oferecem suporte a comandos preparados. Se o banco de dados não oferecer suporte a isso, você pode receber uma mensagem de erro ao executar a página. Mude para a visualização Código e altere a propriedade Prepared para falso.
Se o procedimento armazenado usar parâmetros, é possível criar uma página que reúna os valores de parâmetro e os envie para a página com o procedimento armazenado. Por exemplo, é possível criar uma página que usa parâmetros de URL ou um formulário HTML para reunir valores de parâmetro dos usuários.
Criar belos sites no Dreamweaver
Crie, codifique e gerencie sites dinâmicos com uma ferramenta completa e eficiente.
