Freigeben über

Warnung CA2200: Erneut ausführen, um Stapeldetails beizubehalten.

  • Artikel

Die .NET-Codeanalyseregel CA2200 ist ab .NET 5 standardmäßig aktiviert. Sie erzeugt eine Buildwarnung für alle catch-Blöcke, die eine Ausnahme erneut auslösen, und die Ausnahme wird explizit in der throw-Anweisung angegeben.

Änderungsbeschreibung

Ab .NET 5 umfasst das .NET SDK .NET-Quellcodeanalysen. Mehrere dieser Regeln, einschließlich CA2200, sind standardmäßig aktiviert. Wenn Ihr Projekt Code enthält, der gegen diese Regel verstößt und dafür konfiguriert ist, Warnungen als Fehler zu interpretieren, könnte es sich hierbei um einen Breaking Change für Ihr Build handeln.

Regel CA2200 kennzeichnet Code, bei dem Ausnahmen erneut ausgelöst werden und die Ausnahmevariable in der throw-Anweisung angegeben ist. Wenn eine Ausnahme ausgelöst wird, ist ein Teil der darin enthaltenen Informationen die Stapelüberwachung. Die Stapelüberwachung ist eine Liste der Hierarchie der Methodenaufrufe, die mit der Methode beginnt, die die Ausnahme auslöst, und mit der Methode endet, die die Ausnahme abfängt. Wenn eine Ausnahme durch Angabe der Ausnahme in der throw-Anweisung erneut ausgelöst wird, startet die Stapelüberwachung bei der aktuellen Methode neu. Die Liste der Methodenaufrufe zwischen der ursprünglichen Methode, die die Ausnahme ausgelöst hat, und der aktuellen Methode geht verloren. Um die ursprünglichen Stapelüberwachungsinformation mit der Ausnahme beizubehalten, verwenden Sie die throw-Anweisung ohne Angabe der Ausnahme.

Der folgende Codeausschnitt erzeugt für Regel CA2200 keine Warnung. Die kommentierte Zeile würde jedoch einen Verstoß auslösen.

catch (ArithmeticException e)
{
    // throw e;
    throw;
}

Eingeführt in Version

5.0

  • Lösen Sie Ausnahmen erneut aus, ohne die Ausnahme explizit anzugeben. Weitere Informationen finden Sie unter CA2200.

  • Legen Sie EnableNETAnalyzers in Ihrer Projektdatei auf false fest, um die Codeanalyse vollständig zu deaktivieren. Weitere Informationen finden unter EnableNETAnalyzers.

Betroffene APIs

Nicht über API-Analyse erkennbar.