Compartilhar via


Práticas Recomendadas para usar Trechos de Código IntelliSense

O código em cada trecho de código IntelliSense mostra somente uma forma básica de realizar uma tarefa.Para a maioria dos aplicativos, o código terá que ser modificado para atender o aplicativo.Este tópico descreve várias alterações comuns que devem ser feitas no código.

Manipulando Exceções

Geralmente, se o código contém um bloco Try…Catch, o código irá capturar e relançar todas as exceções.Essa pode não ser a escolha certa para o seu projeto.Para cada exceção, existem várias maneiras de responder.Algumas ações possíveis são:

  • Adicione código a cada bloco Catch, realizando a ação que você escolher.

  • Não faça nada, removendo o código que aparece no bloco Catch.Isso faz com que o aplicativo ignore o erro.É improvável que seu aplicativo recupere graciosamente se você tomar essa atitude.

  • Obtenha mais entradas do usuário para tentar corrigir a condição.

  • Durante a execução do bloco Try, desfaça qualquer alteração que tenha sido feita aos dados do aplicativo antes da exceção ser lançada.

  • Lance a exceção de volta para o método de chamada.

  • Lance uma exceção que você definir para este aplicativo.

  • Exclua a instrução Catch para essa exceção e deixe que o método de chamada a manipule.Isso é especialmente apropriado se a exceção não for relevante para sua tarefa.

  • Adicione blocos Catch adicionais ao código para capturar tipos específicos de exceções que você deseja manipular.

  • Adicione um bloco Finally para adicionar código que você deseja executar depois dos blocos Try e Catch.

Substituindo Sequências de Caracteres

Se o código contém um valor de sequência de caracteres, geralmente é uma sequência específica, como "c:\filename.txt".Essa sequência de caracteres embutida em código é útil para fins de demonstração, mas improvável de ser a sequência correta para seu aplicativo.Fontes potenciais de sequências de caracteres em seu aplicativo são:

  • Uma variável de sequência de caracteres.

  • Um método ou propriedade que retorna uma sequência de caracteres, como a função InputBox.

  • Uma sequência de um controle de Formulários do Windows, como um TextBox ou ComboBox.

Locais de Arquivos

A maioria dos nomes de arquivo no código são mostrados como estando em My Documents ou em c:\.Ao substituir os locais de arquivo, há várias considerações, incluindo:

  • Localize uma localidade acessível.Os usuários podem não ter acesso à pasta \Program Files do computador, então armazenar arquivos junto com os arquivos do aplicativo pode não funcionar.

  • Localize uma localidade seguro.Armazenar arquivos na pasta raiz (c:\) não é seguro.Para dados de aplicativo, é recomendável a pasta \Application Data.Para dados de usuário individuais, o aplicativo pode criar um arquivo para cada usuário na pasta \My Documents.

  • Use um nome de arquivo válido.Você pode usar o OpenFileDialog componente (Windows Forms) e SaveFileDialog componente (Windows Forms) para reduzir a probabilidade de nomes de arquivo inválidos.Esteja ciente que entre o momento o usuário seleciona um arquivo e o momento que seu código manipula o arquivo, o arquivo pode ser excluído.Além disso, o usuário pode não ter permissão para gravar o arquivo.

Controles e Componentes

Nomes de controles e componentes referidos no código normalmente têm um nome de designer padrão, como Button1 ou TreeView1.Isso enfatiza o tipo de controle sendo mostrado, mas talvez não seja um nome que você use em seu aplicativo.

Faltando código

Alguns trechos mostram apenas uma estrutura de idioma vazia, como um bloco Try…Catch.Outro cenário comum é uma variável de validação, como IsValid, que é definida como True por padrão.O código fornecido irá compilar e executar, mas não terá nenhuma funcionalidade.Nesses exemplos, você precisará adicionar o código para sua tarefa.

Segurança

Quanto um trecho é seguro depende de onde ele é usado no código-fonte e como ele é modificado quando ele estiver no código.A lista a seguir contém algumas das áreas que devem ser consideradas.

  • Acesso a banco de dados e a arquivos

  • Segurança de acesso a código

  • Recursos de proteção (como logs de eventos, Registro)

  • Armazenamento de segredos

  • Verificação de entradas

  • Passando dados para tecnologias de script

Para obter mais informações, consulte Considerações de Segurança no Uso de Trechos de Código e Protegendo Aplicativos.

Consulte também

Tarefas

Como: Inserir trechos em seu código (Visual Basic)

Conceitos

Trechos de Código IntelliSense Visual Basic

Considerações de Segurança no Uso de Trechos de Código

Protegendo Aplicativos

Referência

Criando e usando trechos de código IntelliSense