Share via


Nicht verwendete Parameter überprüfen

     TypeName

AvoidUnusedParameters

CheckId

CA1801

Kategorie

Microsoft.Performance

Unterbrechende Änderung

Breaking, NonBreaking

Ursache

Eine Methodensignatur enthält einen Parameter, der nicht im Methodentext verwendet wird. Die folgenden Methoden werden mit dieser Regel nicht geprüft:

  • Methoden, auf die von einem Delegaten verwiesen wird.

  • Methoden, die als Ereignishandler verwendet werden.

  • Methoden, die mit dem abstract-Modifizierer (MustOverride in Visual Basic) deklariert werden.

  • Methoden, die mit dem virtual-Modifizierer (Overridable in Visual Basic) deklariert werden.

  • Methoden, die mit dem override-Modifizierer (Overrides in Visual Basic) deklariert werden.

  • Methoden, die mit dem extern-Modifizierer (Declare-Anweisung in Visual Basic) deklariert werden.

Regelbeschreibung

Überprüfen Sie in nicht virtuellen Methoden die Parameter, die nicht im Methodentext verwendet werden, um sicherzustellen, dass im Umfeld des gescheiterten Zugriffs keine Richtigkeit vorhanden ist. Nicht verwendete Parameter verursachen Wartungsaufwand und beeinträchtigen die Leistung. Gelegentlich kann eine Verletzung dieser Regel auf einen Implementierungsfehler in der Methode hinweisen (d. h., der Parameter hätte eigentlich im Methodentext verwendet werden sollen). Schließen Sie Warnungen dieser Regel aus, wenn der Parameter zwecks Abwärtskompatibilität vorhanden sein muss.

Behandlung von Verstößen

Um einen Verstoß gegen diese Regel zu beheben, entfernen Sie den nicht verwendeten Parameter (eine unterbrechende Änderung), oder verwenden Sie den Parameter im Methodentext (eine nicht unterbrechende Änderung). Wenn der this-Parameter gemeldet wird, ändern Sie die Methodendeklaration, sodass sie den static-Modifizierer (Shared in Visual Basic) enthält (eine unterbrechende Änderung).

Warnungsausschluss

Eine Warnung dieser Regel kann bei zuvor versendetem Code, für den die Korrektur eine unterbrechende Änderung wäre, gefahrlos ausgeschlossen werden.

Verwandte Regeln

Nicht aufgerufenen privaten Code vermeiden

Nicht instanziierte interne Klassen vermeiden

Nicht verwendete lokale Variablen entfernen