Como configurar avisos no Visual Basic

O compilador do Visual Basic inclui um conjunto de avisos sobre o código que podem causar erros em tempo de execução. É possível usar essas informações para escrever códigos mais limpos, mais rápidos e melhores com menos bugs. Por exemplo, o compilador produzirá um aviso quando o usuário tentar invocar um membro de uma variável de objeto não atribuída, retornar de uma função sem definir o valor retornado ou executar um bloco Try com erros na lógica para capturar exceções.

Às vezes, o compilador fornece lógica extra em nome do usuário para que o usuário possa se concentrar na tarefa em questão, em vez de antecipar possíveis erros. Em versões anteriores do Visual Basic, o Option Strict era usado para limitar a lógica adicional fornecida pelo compilador do Visual Basic. A configuração de avisos permite limitar essa lógica de uma maneira mais granular, no nível dos avisos individuais.

Talvez você deseje personalizar seu projeto e desligar alguns avisos não relevantes ao aplicativo enquanto transforma outros avisos em erros. Esta página explica como ativar e desativar avisos individuais.

Ativar e desativar avisos

Há duas maneiras diferentes para configurar avisos: é possível configurá-los usando o Designer de Projeto ou usar as opções /warnaserror e /nowarn do compilador.

A guia Compilar da página Designer de Projeto permite ativar e desativar avisos. Marque a caixa de seleção Desabilitar Todos os Avisos para desabilitar todos os avisos; marque Tratar Todos os Avisos como Erros para tratar todos os avisos como erros. Alguns avisos individuais podem ser ativados/desativados como erro ou aviso, conforme desejado, na tabela exibida.

Quando Opção Estrita é definida como Desativado, os avisos relacionados à Opção Estrita não podem ser tratados independentemente uns dos outros. Quando Opção Estrita é definida como Ativado, os avisos associados são tratados como erros, independentemente de seu status. Quando Opção Estrita é definida como Personalizado especificando /optionstrict:custom no compilador de linha de comando, os avisos da Opção Estrita podem ser ativados ou desativados de forma independente.

A opção de linha de comando /warnaserror do compilador também pode ser usada para especificar se os avisos são tratados como erros. É possível adicionar uma lista delimitada por vírgula a essa opção para especificar quais avisos devem ser tratados como erros ou avisos, usando + ou -. A tabela a seguir fornece detalhes das possíveis opções.

A lista de avisos contém os números de ID de erro dos avisos que devem ser tratados como erros, que podem ser usados com as opções de linha de comando para ativar ou desativar avisos específicos. Se a lista de avisos contiver um número inválido, um erro será relatado.

Exemplos

Esta tabela de exemplos de argumentos de linha de comando descreve a ação de cada argumento.

Tipos de avisos

Veja a seguir uma lista de avisos que você pode desejar tratar como erros.

Aviso de conversão implícita

Gerado para instâncias de conversão implícita. Eles não incluem conversões implícitas de um tipo numérico intrínseco em uma cadeia de caracteres durante o uso do operador &. O padrão para novos projetos é desativado.

ID: 42016

Aviso de invocação de método e resolução de sobrecarga com associação tardia

Gerado para instâncias de associação tardia. O padrão para novos projetos é desativado.

ID: 42017

Avisos de operandos do tipo 'Object'

Gerados quando ocorrem operandos do tipo Object que criarão um erro com Option Strict On. O padrão para novos projetos é ativado.

ID: 42018 e 42019

Avisos de declarações que exigem a cláusula 'As'

Gerados quando uma declaração da variável, função ou propriedade que não tem uma cláusula As cria um erro com Option Strict On. Variáveis que não têm um tipo atribuído a elas são consideradas como sendo do tipo Object. O padrão para novos projetos é ativado.

ID: 42020 (declaração da variável), 42021 (declaração da função) e 42022 (declaração da propriedade).

Avisos de possível exceção de referência nula

Gerados quando uma variável é usada antes de receber um valor. O padrão para novos projetos é ativado.

ID: 42104, 42030

Aviso de variável local não utilizada

Gerado quando uma variável local é declarada, mas nunca referenciada. O padrão é habilitado.

ID: 42024

Aviso de acesso de membro compartilhado por meio de variável de instância

Gerado quando o acesso a um membro compartilhado por meio de uma instância pode ter efeitos colaterais, ou quando o acesso a um membro compartilhado por meio de uma variável de instância não está do lado direito de uma expressão ou está sendo passado como um parâmetro. O padrão para novos projetos é ativado.

ID: 42025

Avisos de operador recursivo ou acesso de propriedade

Gerados quando o corpo de uma rotina usa o mesmo operador ou a mesma propriedade em que é definido. O padrão para novos projetos é ativado.

ID: 42004 (operador), 42026 (propriedade)

Aviso de função ou operador sem o valor retornado

Gerado quando a função ou o operador não tem um valor retornado especificado. Isso inclui a omissão de um Set na variável local implícita com o mesmo nome da função. O padrão para novos projetos é ativado.

ID: 42105 (função), 42016 (operador)

Aviso de modificador de sobrecargas usado em um módulo

Gerado quando Overloads é usado em um Module. O padrão para novos projetos é ativado.

ID: 42028

Avisos de blocos de captura duplicados ou sobrepostos

Gerado quando um bloco Catch nunca é acessado devido à definição de sua relação com outros blocos Catch. O padrão para novos projetos é ativado.

ID: 42029, 42031

Conteúdo relacionado

• Tipos de erro
• Instrução Try...Catch...Finally
• /nowarn
• /warnaserror (Visual Basic)
• Página de compilação, Designer de Projeto (Visual Basic)
• Avisos de compilador desativados por padrão