SuppressMessageAttribute Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Diagnostics.CodeAnalysis

Zestaw:: System.Diagnostics.Tools.dll

Zestaw:: System.Runtime.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pomija raportowanie naruszenia określonej reguły analizy kodu, co pozwala na wiele pomijania na pojedynczym artefaktie kodu. Nie dotyczy diagnostyki kompilatora.

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

Dziedziczenie: Object

Attribute
SuppressMessageAttribute

Atrybuty: AttributeUsageAttribute ConditionalAttribute

Przykłady

Poniższy przykład kodu przedstawia użycie atrybutu SuppressMessageAttribute w celu pomijania komunikatów ostrzegawczych dotyczących wydajności.

#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

Uwagi

Ten atrybut można zastosować do dowolnego elementu aplikacji. Aby uzyskać pełną listę naruszeń, które można pominąć, zobacz Reguły jakości kodu.

Uwaga

Jest ConditionalAttribute stosowany do tej klasy, określając symbol wstępnego przetwarzania "CODE_ANALYSIS" jako symbol warunkowy, który określa, czy wywołanie atrybutu jest dołączone, czy pominięte. Jeśli symbol jest zdefiniowany, dołączane jest wywołanie atrybutu; w przeciwnym razie wywołanie zostanie pominięte.

Po kliknięciu prawym przyciskiem myszy ostrzeżenia analizy kodu w Visual Studio i wybraniu pozycji Pomiń > w pliku pomijania lub Pomiń <rule-ID> <rule-ID> > w źródle (atrybut), atrybut SuppressMessage jest dodawany do pliku globalnych pomijania lub do pliku kodu źródłowego. Aby uzyskać więcej informacji na temat atrybutu SuppressMessage i jego użycia w Visual Studio, zobacz Pomijanie naruszeń analizy kodu.

Konstruktory

SuppressMessageAttribute(String, String)

Inicjuje SuppressMessageAttribute nowe wystąpienie klasy, określając kategorię narzędzia do analizy kodu i identyfikator reguły analizy.

Właściwości

Category	Pobiera kategorię identyfikującą klasyfikację atrybutu.
CheckId	Pobiera identyfikator reguły narzędzia analizy kodu, która ma zostać pominięta.
Justification	Pobiera lub ustawia uzasadnienie pomijania komunikatu analizy kodu.
MessageId	Pobiera lub ustawia rozszerzone kryteria wykluczenia.
Scope	Pobiera lub ustawia zakres kodu, który jest odpowiedni dla atrybutu.
Target	Pobiera lub ustawia w pełni kwalifikowaną ścieżkę reprezentującą docelową analizę kodu.
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attributeelementu . (Odziedziczone po Attribute)

Metody

Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	W przypadku zastąpienia w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	Po przesłonięciu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania. (Odziedziczone po Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Pobiera informacje o typie dla obiektu, który może służyć do pobierania informacji o typie dla interfejsu. (Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1). (Odziedziczone po Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt. (Odziedziczone po Attribute)

Dotyczy