Sdílet prostřednictvím

Übersicht über die Unterdrückung im Quellcode

  • Článek

Aktualisiert: November 2007

Bei der Unterdrückung im Quellcode handelt es sich um die Fähigkeit, Verletzungen der Codeanalyseregeln mithilfe des SuppressMessage-Attributs zu unterdrücken oder zu ignorieren. Das bedingte SuppressMessage-Attribut wird nur in die IL-Metadaten einer Assembly mit verwaltetem Code eingeschlossen, wenn das CODE_ANALYSIS-Kompilierungssymbol zur Kompilierungszeit definiert wird. In C++ wird dasselbe Ergebnis mit dem CA_SUPPRESS_MESSAGE-Makro und dem CA_GLOBAL_SUPPRESS_MESSAGE-Makro erreicht.

Es wird empfohlen, die Unterdrückung im Quellcode in Debug- oder Eincheckbuilds zu verwenden, um zu verhindern, dass die aus der Unterdrückung im Quellcode resultierenden Metadaten versehentlich mit der Software ausgeliefert werden und dass Ausführung und Leistung aufgrund des hohen Metadatenumfangs beeinträchtigt werden.

ms244717.alert_note(de-de,VS.90).gifHinweis:

Diese Attribute müssen nicht manuell codiert werden. Weitere Informationen finden Sie unter Gewusst wie: Unterdrücken von Warnungen über das Menü.

SuppressMessage-Attribut

Wenn Sie mit der rechten Maustaste in der Fehlerliste auf eine Codeanalysewarnung klicken und dann auf Meldung(en) unterdrücken klicken, wird entweder dem Code oder der globalen Unterdrückungsdatei des Projekts ein SuppressMessage-Attribut hinzugefügt.

Das SuppressMessage-Attribut verfügt über folgendes Format:

<Scope:SuppressMessage("Rule Category", "Rule Id", "Justification", "MessageId", Scope = "Scope", Target = "Target")>

[Scope:SuppressMessage("Rule Category", "Rule Id", "Justification", "MessageId", Scope = "Scope", Target = "Target")]

Dabei ist:

  • Rule Category: Die Kategorie, in der die Regel definiert wird.

  • Rule Id: Der Bezeichner der Regel. Für die Regel-ID werden sowohl ein kurzer als auch ein langer Name unterstützt. Der kurze Name lautet CAXXXX, der lange Name CAXXXX:FriendlyTypeName.

  • Justification: Der Text, mit dem der Grund für die Unterdrückung der Meldung dokumentiert wird.

  • Message Id: Der eindeutige Bezeichner eines Problems für die einzelnen Meldungen.

  • Scope: Das Ziel, für das die Warnung unterdrückt wird. Wenn kein Ziel angegeben wird, wird das Ziel des Attributs festgelegt. Folgende Bereiche werden unterstützt:

    • Modul

    • Namespace

    • Ressource

    • Typ

    • Member

    • Parameter

  • Target: Ein Bezeichner, mit dem das Ziel angegeben wird, für das die Warnung unterdrückt wird. Er muss einen vollständig qualifizierten Elementnamen enthalten.

Verwendung von SuppressMessage

Codeanalysewarnungen werden auf der Ebene unterdrückt, auf die eine Instanz des SuppressMessage-Attributs angewendet wird. Der Zweck besteht darin, die Unterdrückungsinformationen eng an den Code zu koppeln, in dem die Verletzung auftritt.

In der allgemeinen Form umfasst eine Unterdrückung die Regelkategorie sowie einen Regelbezeichner, der optional eine lesbare Darstellung des Regelnamens umfasst. Beispiel:

[SuppressMessage("Microsoft.Design", "CA1039:ListsAreStrongTyped")]

Wenn die Metadaten für die Unterdrückung im Quellcode aus Gründen der Leistungsoptimierung minimiert werden müssen, kann der Regelname weggelassen werden. Die Regelkategorie und die zugehörige Regel-ID bilden zusammen einen hinreichend eindeutigen Regelbezeichner. Beispiel:

[SuppressMessage("Microsoft.Design", "CA1039")]

Dieses Format wird aufgrund von Problemen bei der Verwaltbarkeit nicht empfohlen.

Unterdrücken mehrerer Regelverletzungen in einem Methodentext

Attribute können nur für eine Methode übernommen und nicht in den Methodentext eingebettet werden. Sie können den Bezeichner jedoch als Meldungs-ID angeben, um mehrere Vorkommen einer Verletzung innerhalb einer Methode voneinander unterscheiden zu können.

Imports System

Namespace InSourceSuppression
    Public Class Class1
        <System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Usage", _
        "CA1801:ReviewUnusedParameters", MessageId:="guid")> _
        Shared Function IsValidGuid(ByVal guid As String) As Boolean
            Try
                Return True
            Catch e As ArgumentNullException
            Catch e As OverflowException
            Catch e As FormatException
            End Try

            Return False
        End Function
    End Class
End Namespace

using System;

namespace InSourceSuppression
{
    public class Class1
    {
    [System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Usage",
    "CA1806:DoNotIgnoreMethodResults", MessageId = "System.Guid")]
        public static bool IsValidGuid(string guid)
        {
            try
            {
              new Guid(guid); //Causes CA1806: DoNotIgnoreMethodResults
              return true;
            }
            catch (ArgumentNullException) {}
            catch (OverflowException) {}
            catch (FormatException) {}
            return false;
        }
    }
}

Generierter Code

Compiler für verwalteten Code und einige Tools von Drittanbietern generieren Code, um eine schnelle Codeentwicklung zu ermöglichen. Vom Compiler generierter Code in Quelldateien wird normalerweise mit dem GenerateCodeAttribute-Attribut gekennzeichnet.

Sie können entscheiden, ob Codeanalysewarnungen und -fehler aus generiertem Code unterdrückt werden sollen. Informationen zum Unterdrücken dieser Warnungen und Fehler finden Sie unter Codeanalyseeigenschaften für verwalteten Code.

Beachten Sie, dass GenerateCodeAttribute von der Codeanalyse ignoriert wird, wenn es auf eine vollständige Assembly oder einen einzelnen Parameter angewendet wird. Diese Situationen treten selten auf.

Unterdrückung auf globaler Ebene

Das Analysetool für verwalteten Code untersucht die SuppressMessage-Attribute, die auf der Assembly-, Modul-, Typ-, Member- oder Parameterebene angewendet werden. Zudem werden Verletzungen bei Ressourcen und Namespaces ausgelöst. Diese Verletzungen müssen auf globaler Ebene angewendet werden und sind bereichs- und zielbezogen. Durch die folgende Meldung wird zum Beispiel eine Namespaceverletzung unterdrückt:

[module: SuppressMessage("Microsoft.Design", "CA1020:AvoidNamespacesWithFewTypes", Scope = "namespace", Target = "MyNamespace")]

ms244717.alert_note(de-de,VS.90).gifHinweis:

Wenn Sie eine Warnung mit Namespacebereich unterdrücken, wird die Warnung für den Namespace selbst unterdrückt. Warnungen für Typen innerhalb des Namespaces werden nicht unterdrückt.

Jede Unterdrückung kann durch die Angabe eines expliziten Bereichs ausgedrückt werden. Diese Art der Unterdrückung muss auf globaler Ebene erfolgen. Sie können keine Unterdrückung auf Memberebene festlegen, indem Sie einen Typ ergänzen.

Unterdrückungen auf globaler Ebene sind die einzige Möglichkeit, Meldungen zu unterdrücken, die sich auf Code beziehen, der vom Compiler generiert wurde und sich keiner explizit angegebenen Benutzerquelle zuordnen lässt. Mit dem folgenden Code wird z. B. eine Verletzung in Bezug auf einen vom Compiler ausgegebenen Konstruktor unterdrückt:

[module: SuppressMessage("Microsoft.Design", "CA1055:AbstractTypesDoNotHavePublicConstructors", Scope="member", Target="Microsoft.Tools.FxCop.Type..ctor()")]

ms244717.alert_note(de-de,VS.90).gifHinweis:

Target enthält immer den vollständig qualifizierten Elementnamen.

Globale Unterdrückungsdatei

In der globalen Unterdrückungsdatei werden Unterdrückungen auf globaler Ebene bzw. Unterdrückungen ohne Ziel verwaltet. So werden in dieser Datei z. B. Verletzungen auf Assemblyebene gespeichert. Außerdem werden einige ASP.NET-Unterdrückungen in dieser Datei gespeichert, da für Code, der einem Formular zugrunde liegt, keine Einstellungen auf Projektebene verfügbar sind.

Siehe auch

Referenz

System.Diagnostics.CodeAnalysis