Share via

Verwenden des Regelsatz-Editors für die Codeanalyse

  • Artikel

Mit dem Codeanalyseregelsatz-Editor können Sie die Regeln angeben, die in einem benutzerdefinierten Regelsatz enthalten sind, und den Schweregrad von Regelverstößen festlegen.

Die folgende Tabelle enthält die Schweregradoptionen:

Aktion (Schweregrad) BESCHREIBUNG
Warnung Generiert eine Warnung in der Fehlerliste und zur Buildzeit.
Fehler Generiert einen Fehler in der Fehlerliste und zur Buildzeit.
Info Generiert eine Meldung in der Fehlerliste.
Ausgeblendet Der Verstoß ist für den Benutzer nicht sichtbar. Die IDE wird jedoch über den Verstoß benachrichtigt.
Keine Die Regel wird unterdrückt. Das Verhalten ist identisch mit dem, wenn die Regel aus dem Regelsatz entfernt wird.

Der Editor zeigt die Regeln in einer Struktur an, die die Regeln nach einem von Ihnen angegebenen Regelsatzfeld gruppiert. Führen Sie mindestens einen der folgenden Schritte aus, um einem Regelsatz Regeln hinzuzufügen oder daraus zu entfernen:

  • Aktivieren oder deaktivieren Sie das Kontrollkästchen des Gruppenknotens, um alle Regeln in der Gruppe hinzuzufügen oder zu entfernen. Wenn Sie eine Gruppe auswählen, wird für alle Regeln die Aktion Warnung festgelegt.

    Tipp

    Sie können die Gruppierung von Regeln in der Dropdownliste Gruppieren nach ändern.

  • Klicken Sie auf das Feld Aktion einer Gruppe, und geben Sie die Aktion an, die auf alle Regeln in der Gruppe angewendet werden soll.

  • Aktivieren oder deaktivieren Sie das Kontrollkästchen für eine einzelne Regel. Wenn Sie das Kontrollkästchen für eine Regel aktivieren, wird für die Regel die Aktion Warnung festgelegt.

Symbolleiste

Sie können die Symbolleiste des Regelsatz-Editors verwenden, um die im Regelsatzraster angezeigten Daten zu gruppieren, zu filtern und zu durchsuchen.

In der folgenden Tabelle werden die Steuerelemente auf der Symbolleiste des Regelsatz-Editors beschrieben.

ToolBar-Steuerelement BESCHREIBUNG
Alle aufklappen Zeigt die Regeln in allen Gruppen an.
Alle reduzieren Blendet die Regeln in allen Gruppen aus.
Group By Gibt das Feld an, nach dem Regeln gruppiert werden. Klicken Sie auf <Keine>, um die Regeln ohne Gruppen anzuzeigen.
Spaltenoptionen Gibt die anzuzeigenden Regelfelder an.
Regeln ausblenden, die nicht für die aktuelle Lösung gelten Blendet Regeln ein oder aus, die nicht den gleichen Zieltyp wie die Projektmappe aufweisen.
Regeln anzeigen, die Code Analysis-Fehler generieren können Blendet Regeln ein oder aus, denen die Aktion „Fehler“ zugewiesen ist.
Regeln anzeigen, die Code Analysis-Warnungen generieren können Blendet Regeln ein oder aus, denen die Aktion „Warnung“ zugewiesen ist.
Regeln anzeigen, die nicht aktiviert sind Blendet Regeln ein oder aus, denen die Aktion „Keine“ zugewiesen ist.
Untergeordnete Regelsätze hinzufügen oder entfernen Fügt die Regeln in den ausgewählten Regelsätzen hinzu oder entfernt sie.
Suchregeln Durchsucht alle Feldwerte nach der von Ihnen angegebenen Zeichenfolge.

Regelsatzfelder

Regelsatzfelder zeigen Informationen zu einem Regelsatz an und können zum Sortieren und Gruppieren der Regelliste verwendet werden. Wählen Sie zum Anzeigen oder Ausblenden von Feldern auf der Symbolleiste des Regelsatz-Editors die Option Spaltenoptionen aus, und aktivieren oder deaktivieren Sie dann die Kontrollkästchen der Felder, die ein- oder ausgeblendet werden sollen.

In der folgenden Tabelle werden die Felder eines Regelsatzes beschrieben:

Feld BESCHREIBUNG
ID Der Bezeichner der Regel.
Kategorie Zusätzlich zur Mitgliedschaft in Regelsätzen werden Codeanalyseregeln auch nach Kategorie gruppiert. Weitere Informationen finden Sie unter Codeanalysewarnungen.
Name Der Titel der Regel.
Namespace Der Namespace der Regel.
Zieltyp Gibt an, ob die Regel für systemeigenen, verwalteten oder Datenbankcode gilt.
Aktion Die Aktion, die ausgeführt wird, wenn die Regel in einer Codeanalyseausführung verletzt wird. Sie können das Feld Aktion bearbeiten.
Quellregelsätze Der Regelsatz, der die Regel enthält.

Sortieren und Filtern von Regelsätzen

In den Spaltenüberschriften des Regelsatzrasters können Sie die Regeln nach den Werten des Felds sortieren und filtern.

  • Um die Regelsatzlisten zu sortieren, wählen Sie die Spaltenüberschrift des Felds aus, nach dem Sie sortieren möchten. Wenn die Regelsätze gruppiert sind, wird jede Gruppe einzeln sortiert.

  • Um die Regelsätze nach dem Wert eines Felds zu filtern, wählen Sie die Filterschaltfläche in der Spaltenüberschrift des Felds aus, nach dem Sie filtern möchten. Aktivieren Sie die Kontrollkästchen der Werte, die Sie anzeigen möchten, und deaktivieren Sie die Kontrollkästchen der Werte, die Sie ausblenden möchten.

Zugehöriger Inhalt