Botões de comando do catálogo de endereços

Artigo
05/30/2023

O aplicativo Catálogo de Endereços inclui os seguintes botões de comando:

Um botão Localizar para enviar uma consulta ao banco de dados.
Um botão Limpar para limpar as caixas de texto antes de iniciar uma nova pesquisa.
Um botão Atualizar Perfil para salvar as alterações em um registro de funcionário.
Um botão Cancelar Alterações para descartar as alterações.

Importante

A partir do Windows 8 e do Windows Server 2012, os componentes do servidor RDS não estão mais incluídos no sistema operacional Windows (confira Windows 8 e Manual de Compatibilidade do Windows Server 2012 para obter mais detalhes). Os componentes do cliente RDS serão removidos em uma versão futura do Windows. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Os aplicativos que usam o RDS devem migrar para o Serviço de Dados do WCF.

Botão Localizar

Se você clicar no botão Localizar, isso ativará o procedimento Sub Find_OnClick do VBScript, que compila e envia a consulta SQL. Um clique nesse botão preenche a grade de dados.

Como criar a consulta SQL

A primeira parte do procedimento Sub Find_OnClick compila a consulta SQL, uma frase por vez, acrescentando cadeias de caracteres de texto a uma instrução SQL SELECT global. Ele começa definindo a variável myQuery como uma instrução SQL SELECT que solicita todas as linhas de dados da tabela de fonte de dados. Em seguida, o procedimento Sub examina cada uma das quatro caixas de entrada na página.

Como o programa usa a palavra like na criação das instruções SQL, as consultas são pesquisas de subcadeias de caracteres em vez de correspondências exatas.

Por exemplo, se a caixa Name contiver a entrada "Berge" e a caixa Title contiver a entrada "Gerente de Programas", a instrução SQL (valor de myQuery) indicará:

Select FirstName, LastName, Title, Email, Building, Room, Phone from Employee where lastname like 'Berge%' and title like 'Program Manager%'

Se a consulta tiver sido bem-sucedida, todas as pessoas com um sobrenome contendo o texto "Berge" (como Berge e Berger) e com um cargo contendo as palavras "Gerente de Programas" (por exemplo, Gerente de Programas, Tecnologias Avançadas) serão exibidas na grade de dados HTML.

Como preparar e enviar a consulta

A última parte do procedimento Sub Find_OnClick consiste em duas instruções. A primeira instrução atribui a propriedade SQL do objeto RDS.DataControl igual à consulta SQL criada dinamicamente. A segunda instrução faz com que o objeto RDS.DataControl (DC1) consulte o banco de dados e exiba os novos resultados da consulta na grade.

Sub Find_OnClick  
   '...  
   DC1.SQL = myQuery  
   DC1.Refresh  
End Sub

Botão Atualizar Perfil

Se você clicar no botão Atualizar Perfil, isso ativará o procedimento Sub Update_OnClick do VBScript, que executa os métodos SubmitChanges e Refresh do objeto RDS.DataControl (DC1).

Sub Update_OnClick  
   DC1.SubmitChanges  
   DC1.Refresh  
End Sub

Quando DC1.SubmitChanges é executado, o Serviço de Dados Remotos empacota todas as informações de atualização e as envia para o servidor via HTTP. A atualização é tudo ou nada. Se uma parte dela não for bem-sucedida, nenhuma das alterações será feita e uma mensagem de status será retornada. DC1.Refresh não é necessário após SubmitChanges com o Serviço de Dados Remotos, mas garante novos dados.

Botão Cancelar Alterações

Se você clicar em Cancelar Alterações, isso ativará o procedimento Sub Cancel_OnClick do VBScript, que executa o objeto RDS.DataControl (DC1) método CancelUpdate).

Sub Cancel_OnClick  
   DC1.CancelUpdate  
End Sub

Quando DC1.CancelUpdate é executado, ele descarta todas as edições feitas por um usuário em um registro de funcionário na grade de dados desde a última consulta ou atualização. Ele restaura os valores originais.

Confira também

Botões de navegação do catálogo de endereços
Objeto DataControl (RDS)

Compartilhar via