SuppressMessageAttribute Classe

Definição

Suprime o relatório de uma violação de regra de análise de código específica, permitindo várias supressões em um único artefato de código. Não se aplica ao diagnóstico do compilador.

public ref class SuppressMessageAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.All, AllowMultiple=true, Inherited=false)]
[System.Diagnostics.Conditional("CODE_ANALYSIS")]
public sealed class SuppressMessageAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.All, AllowMultiple=true, Inherited=false)>]
[<System.Diagnostics.Conditional("CODE_ANALYSIS")>]
type SuppressMessageAttribute = class
    inherit Attribute
Public NotInheritable Class SuppressMessageAttribute
Inherits Attribute
Herança
SuppressMessageAttribute
Atributos

Exemplos

O exemplo de código a seguir mostra o uso do atributo para suprimir mensagens de SuppressMessageAttribute aviso de desempenho.

#define CODE_ANALYSIS
using System;
using System.Diagnostics.CodeAnalysis;

namespace CodeAnalysisSample
{
    class Library
    {
        [SuppressMessage("Microsoft.Performance", "CA1801:ReviewUnusedParameters", MessageId = "isChecked")]
        [SuppressMessage("Microsoft.Performance", "CA1804:RemoveUnusedLocals", MessageId = "fileIdentifier")]
        static void FileNode(string name, bool isChecked)
        {
            string fileIdentifier = name;
            string fileName = name;
            string version = String.Empty;
        }
    }
}
#Const CODE_ANALYSIS = True
Imports System.Diagnostics.CodeAnalysis



Class Library
    
    <SuppressMessage("Microsoft.Performance", "CA1801:ReviewUnusedParameters", MessageId:="isChecked"), _
     SuppressMessage("Microsoft.Performance", "CA1804:RemoveUnusedLocals", MessageId:="fileIdentifier")> _
    Shared Sub FileNode(ByVal name As String, ByVal isChecked As Boolean)
        Dim fileIdentifier As String = name
        Dim fileName As String = name
        Dim version As String = String.Empty

    End Sub
End Class

Comentários

Esse atributo pode ser aplicado a qualquer elemento de aplicativo. Para obter uma lista completa das violações que podem ser suprimidas, consulte as regras de qualidade de código.

Note

Ele ConditionalAttribute é aplicado a essa classe, especificando o símbolo de pré-processamento "CODE_ANALYSIS" como o símbolo condicional que determina se a chamada de atributo está incluída ou omitida. Se o símbolo for definido, a chamada de atributo será incluída; caso contrário, a chamada será omitida.

Ao clicar com o botão direito do mouse em um aviso de análise de código no Visual Studio e escolher Suppress <rule-ID>> em Arquivo de Supressão ou Suppress <rule-ID>> in Source (attribute), um atributo SuppressMessage é adicionado ao arquivo de supressões globais ou ao arquivo de código-fonte. Para obter mais informações sobre o atributo SuppressMessage e seu uso em Visual Studio, consulte Suppress code analysis violations.

Construtores

Nome Description
SuppressMessageAttribute(String, String)

Inicializa uma nova instância da SuppressMessageAttribute classe, especificando a categoria da ferramenta de análise de código e o identificador para uma regra de análise.

Propriedades

Nome Description
Category

Obtém a categoria que identifica a classificação do atributo.

CheckId

Obtém o identificador da regra da ferramenta de análise de código a ser suprimida.

Justification

Obtém ou define a justificativa para suprimir a mensagem de análise de código.

MessageId

Obtém ou define os critérios de exclusão expandidos.

Scope

Obtém ou define o escopo do código relevante para o atributo.

Target

Obtém ou define um caminho totalmente qualificado que representa o destino de análise de código.

TypeId

Quando implementado em uma classe derivada, obtém um identificador exclusivo para esse Attribute.

(Herdado de Attribute)

Métodos

Nome Description
Equals(Object)

Retorna um valor que indica se essa instância é igual a um objeto especificado.

(Herdado de Attribute)
GetHashCode()

Devolve o código hash para esta instância.

(Herdado de Attribute)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IsDefaultAttribute()

Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada.

(Herdado de Attribute)
Match(Object)

Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado.

(Herdado de Attribute)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Implantações explícitas de interface

Nome Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição.

(Herdado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera as informações de tipo de um objeto, que podem ser usadas para obter as informações de tipo de uma interface.

(Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Retorna o número de interfaces de informações do tipo que um objeto fornece (0 ou 1).

(Herdado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornece acesso a propriedades e métodos expostos por um objeto.

(Herdado de Attribute)

Aplica-se a