Exemplarische Vorgehensweise: Analysieren von verwaltetem Code auf Codefehler

Artikel
07/20/2011

In dieser exemplarischen Vorgehensweise analysieren Sie mit dem Codeanalysetool ein verwaltetes Projekt, um Codefehler zu ermitteln.

Sie werden Schritt für Schritt durch den Vorgang der Codeanalyse geführt, bei der Sie .NET-Assemblys mit verwaltetem Code im Hinblick auf die Einhaltung der Microsoft .NET Framework-Entwurfsrichtlinien überprüfen.

In dieser exemplarischen Vorgehensweise führen Sie folgende Schritte aus:

Analysieren von Codefehlerwarnungen und Beheben der Fehler

Vorbereitungsmaßnahmen

Visual Studio Premium.

Erstellen einer Klassenbibliothek

So erstellen Sie eine Klassenbibliothek

Klicken Sie im Menü Datei von Visual Studio auf Neu und dann auf Projekt.
Klicken Sie im Dialogfeld Neues Projekt unter Projekttypen auf Visual C#.
Wählen Sie unter Vorlagen die Option Klassenbibliothek aus.
Geben Sie im Textfeld Name die Zeichenfolge CodeAnalysisManagedDemo ein, und klicken Sie dann auf OK.
Wenn das Projekt erstellt wurde, öffnen Sie die Datei Class1.cs.

Ersetzen Sie den vorhandenen Text in Class1.cs durch folgenden Code:

//CodeAnalysisManagedDemo
//Class1.cs
using System;
namespace testCode
{
    
    public class demo : Exception
    {
        
        public static void Initialize(int size) { }
        protected static readonly int _item;
        public static int item { get { return _item; } }
    }
}

Speichern Sie die Datei Class1.cs.

Analysieren des Projekts

So analysieren Sie ein verwaltetes Projekt auf Codefehler

Wählen Sie im Projektmappen-Explorer das Projekt CodeAnalysisManagedDemo aus.
Klicken Sie im Menü Projekt auf Eigenschaften.

Die Eigenschaftenseite für CodeAnalysisManagedDemo wird angezeigt.
Klicken Sie auf Codeanalyse.
Aktivieren Sie Codeanalyse beim Erstellen aktivieren (definiert die CODE_ANALYSIS-Konstante).
Wählen Sie aus der Dropdownliste Diesen Regelsatz ausführen die Option Alle Microsoft-Regeln aus.
Klicken Sie im Menü Datei auf Ausgewählte Elemente speichern, und schließen Sie dann die Eigenschaftenseiten für ManagedDemo.
Klicken Sie im Menü Erstellen auf ManagedDemo erstellen.

Die Buildwarnungen zum Projekt CodeAnalysisManagedDemo werden in den Fenstern Fehlerliste und Ausgabe angezeigt.

Korrigieren der Codeanalyseprobleme

So korrigieren Sie Verletzungen der Codeanalyseregeln

Klicken Sie im Menü Ansicht auf Fehlerliste.

Je nach ausgewähltem Entwicklerprofil müssen Sie im Menü Ansicht möglicherweise zuerst auf Weitere Fenster zeigen, bevor Sie auf Fehlerliste klicken können.
Klicken Sie im Projektmappen-Explorer auf Alle Dateien anzeigen.
Erweitern Sie den Knoten Eigenschaften, und öffnen Sie dann die Datei AssemblyInfo.cs.
Korrigieren Sie die den folgenden Warnungen zugrunde liegenden Fehler anhand der Angaben in der folgenden Tabelle:

Warnungen	Fehlerkorrektur
CA1014: Assemblys mit CLSCompliantAttribute markieren: Microsoft.Design: 'demo' sollte mit CLSCompliantAttribute markiert sein, und der Wert sollte True sein.	Fügen Sie der Datei AssemblyInfo.cs den Code using System; hinzu. Fügen Sie dann am Ende der Datei AssemblyInfo.cs den Code [assembly: CLSCompliant(true)] hinzu. Erstellen Sie das Projekt neu.
CA1032: Standardausnahmekonstruktoren implementieren: Microsoft.Design: Fügen Sie dieser Klasse den folgenden Konstruktor hinzu: public demo(String)	Fügen Sie der Klasse demo den Konstruktor public demo (String s) : base(s) { } hinzu.
CA1032: Standardausnahmekonstruktoren implementieren: Microsoft.Design: Fügen Sie dieser Klasse den folgenden Konstruktor hinzu: public demo(String, Exception)	Fügen Sie der Klasse demo den Konstruktor public demo (String s, Exception e) : base(s, e) { } hinzu.
CA1032: Standardausnahmekonstruktoren implementieren: Microsoft.Design: Fügen Sie dieser Klasse den folgenden Konstruktor hinzu: protected demo(SerializationInfo, StreamingContext)	Fügen Sie am Anfang der Datei Class1.cs hinzu den Code using System.Runtime.Serialization; hinzu. Fügen Sie dann den Konstruktor protected demo (SerializationInfo info, StreamingContext context) : base(info, context) { } to the class demo. hinzu. Erstellen Sie das Projekt neu.
CA1032: Standardausnahmekonstruktoren implementieren: Microsoft.Design: Fügen Sie dieser Klasse den folgenden Konstruktor hinzu: public demo()	Fügen Sie der Klasse demo den Konstructor public demo () : base() { } hinzu. Erstellen Sie das Projekt neu.
CA1709: Bei Bezeichnern sollte die Groß-/Kleinschreibung beachtet werden: Microsoft.Naming: Korrigieren Sie die Groß-/Kleinschreibung des Namespacenamens 'testCode' in 'TestCode'.	Ändern Sie die Schreibweise des Namespacenamens testCode in TestCode.
CA1709: Bei Bezeichnern sollte die Groß-/Kleinschreibung beachtet werden: Microsoft.Naming: Korrigieren Sie die Groß-/Kleinschreibung des Typnamens 'demo' in 'Demo'.	Ändern Sie den Namen des Members in Demo.
CA1709: Bei Bezeichnern sollte die Groß-/Kleinschreibung beachtet werden: Microsoft.Naming: Korrigieren Sie die Groß-/Kleinschreibung des Membernamens 'item' in 'Item'.	Ändern Sie den Namen des Members in Item.
CA1710: Bezeichner sollten ein richtiges Suffix aufweisen: Microsoft.Naming: Benennen Sie 'testCode.demo' so um, dass die Endung 'Exception' lautet.	Ändern Sie den Namen der Klasse und der zugehörigen Konstruktoren in DemoException.
CA2210: Assemblys müssen gültige starke Namen aufweisen: Signieren Sie 'ManagedDemo' mit einem Schlüssel mit starkem Namen.	Klicken Sie im Menü Projekt auf Eigenschaften von ManagedDemo. Die Projekteigenschaften werden angezeigt. Klicken Sie auf Signierung. Aktivieren Sie das Kontrollkästchen Assembly signieren. Wählen Sie in der Liste Schlüsseldatei mit starkem Namen auswählen die Option <Neu...> aus. Das Dialogfeld Schlüssel für einen starken Namen erstellen wird geöffnet. Geben Sie im Feld Schlüsseldateiname den Namen TestKey ein. Geben Sie ein Kennwort ein, und klicken Sie dann auf OK. Klicken Sie im Menü Datei auf Ausgewählte Elemente speichern, und schließen Sie dann die Eigenschaftenseiten. Erstellen Sie das Projekt neu.
CA2237: Markieren von ISerializable-Typen mit SerializableAttribute: Microsoft.Usage: Fügen Sie 'demo' [Serializable] hinzu, da dieser Typ ISerializable implementiert.	Fügen Sie der Klasse demo das [Serializable ()]-Attribut hinzu. Erstellen Sie das Projekt neu.

Ausschließen von Codeanalysewarnungen

So schließen Sie Codefehlerwarnungen aus

Wählen Sie die verbleibenden Warnungen in der Fehlerliste aus, klicken Sie dann mit der rechten Maustaste, zeigen Sie auf Meldung(en) unterdrücken, klicken Sie darauf, und klicken Sie dann auf In Projektunterdrückungsdatei. Weitere Informationen finden Sie unter Gewusst wie: Unterdrücken von Warnungen über das Menüelement.
Erstellen Sie das Projekt neu.

Das Projekt wird ohne Warnungen oder Fehler erstellt.

Freigeben über