Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Dieser Artikel enthält eine Übersicht über die Codeanalysefunktion des .NET-Upgrade-Assistenten. Die Codeanalyse generiert einen Bericht basierend auf Der Projektkonfiguration, Abhängigkeiten und Code. Der Bericht enthält Informationen zu potenziellen Problemen und Problemen, die während des Upgrades auftreten können, und welche Schritte Sie ausführen können, um diese Probleme zu beheben.
Von Bedeutung
Der .NET-Upgrade-Assistent ist offiziell veraltet. Verwenden Sie stattdessen den GitHub Copilot-Modernisierungschat-Agent , der in Visual Studio 2026 und Visual Studio 2022 17.14.16 oder höher enthalten ist. Dieser Agent analysiert Ihre Projekte und Abhängigkeiten, erstellt einen schrittweisen Migrationsplan mit gezielten Empfehlungen und automatisierten Codefixes und führt einen Commit für jede Änderung durch, sodass Sie ein Rollback ausführen können. Es automatisiert allgemeine Portierungsaufgaben – Aktualisieren von Projektdateien, Ersetzen veralteter APIs und Beheben von Buildproblemen – sodass Sie schneller mit weniger manuellem Aufwand modernisieren können.
Analysetypen
Es gibt zwei Arten von Analysen, die Sie für Ihren Code ausführen können:
Quellcode und Einstellungen
Analysiert Den Quellcode, die Konfiguration und die Einstellungen.
Binäre Abhängigkeiten
Analysiert die externen binären Abhängigkeiten (z. B. NuGet-Pakete) für Ihre Projekte.
Berichte
Nach Abschluss der Analyse wird ein Dashboardbericht generiert. In diesem Bericht werden die Ergebnisse nach Projekt-, Datei-, Vorfall- und Storypunkten aufgeschlüsselt. Eine aggregierte Ansicht ist ebenfalls verfügbar, um ähnliche Probleme unabhängig vom Projekt, in dem sie festgestellt wurden, zu gruppieren.
Tipp
"Story Points sind ein agiles Konzept, das hilft, die Komplexität und den Aufwand zu schätzen, der erforderlich ist, um ein Problem zu beheben." Weitere Informationen finden Sie im Abschnitt "Vorfall-Story-Punkte".
Jedes Problem im Bericht wird nach Schweregrad kategorisiert, um Sie bei der Priorisierung von Korrekturen zu unterstützen, die Sie vornehmen müssen. Themen sind entweder verpflichtend oder optional. Obligatorische Probleme blockieren das Upgrade. Optionale Aspekte bieten die Möglichkeit, auf eine neuere Funktion, Bibliothek oder Codeerweiterung aufzurüsten.
In den folgenden Abschnitten werden die Bereiche des Berichts ausführlich beschrieben.
Dashboard
Die Dashboard-Seite bietet eine Ansicht der Vorfälle, die durch den Scan erkannt wurden, gruppiert in Bereiche:
Zusammenfassung
Projekte
Dies ist die Anzahl der Projekte, bei denen ein Vorfall erkannt wurde.
Probleme
Die Anzahl der eindeutigen Regeln, die während des Scans ausgelöst wurden. Jedes Problem verfügt über einen eigenen Schweregrad und einen eigenen Verlaufspunkt, zusammen mit jeder erkannten Instanz (Vorfall).
Incidents
Ein Vorfall ist eine Instanz eines erkannten Problems an einem bestimmten Ort, z. B. einem Codeteil oder einer Binärdatei. Jeder Vorfall enthält die Kontextinformationen, die das Problem ausgelöst haben.
Story-Punkte
Die Gesamtzahl der Story-Punkte, die zur Durchführung des Upgrades erforderlich sind. Weitere Informationen darüber, was ein Storypunkt ist, finden Sie im Abschnitt "Vorfall-Storypunkte".
Schweregrad und Kategorien
In diesen beiden Bereichen werden Diagramme angezeigt, in denen die Vorfälle nach Schweregrad und Kategorie gruppiert werden. Weitere Informationen zum Schweregrad finden Sie im Abschnitt "Vorfallschweregrad ".
Projekte
Auf der Seite "Projekte " werden die Probleme, Vorfälle und Storypunkte nach Projekt aufgeschlüsselt. Jedes Projekt ist ein Link, der einen nach diesem Projekt gefilterten Drilldown-Bericht öffnet.
Aggregierte Probleme
Auf der Seite "Aggregierte Probleme " werden die einzelnen probleme beschrieben, die ausgelöst wurden. Jedes Problem kann erweitert werden, um alle Vorkommnisse dieses Problems aufzulisten. Mithilfe der Spalte "Bundesland " können Sie nachverfolgen, welche Probleme Sie behoben oder als nicht anwendbar eingestuft haben.
Schweregrad des Vorfalls
Jeder Problemvorfall weist einen zugehörigen Schweregrad auf, der das Upgrade möglicherweise blockiert. Der Schweregrad hilft Ihnen zu verstehen, was aktualisiert werden muss, damit das Upgrade erfolgreich ausgeführt werden kann.
| Schweregrad | Beschreibung |
|---|---|
| Obligatorisch. | Es muss angegangen werden. Der Upgradeprozess kann diese Probleme für Sie behandeln, z. B. das Aktualisieren der Zielframeworklaufzeit (TARGET Framework Runtime, TFM). |
| Optional | Dies sollte kein Problem mit dem Upgrade darstellen, sie sollten jedoch vor oder nach dem Upgrade berücksichtigt werden. |
| Potential | Probleme, die nach dem Upgrade möglicherweise zu Problemen führen können, wenn Sie sie jetzt nicht beheben. |
| Informationen | Zusätzliche Informationen im Zusammenhang mit dem Upgrade. |
Story-Punkte für Vorfälle
Jeder Problemvorfall weist einen zugeordneten Storypoint auf. Ein Story-Punkt ist eine Maßeinheit, um die Komplexität eines Vorfalls zu messen, was hilft, die Zeit zu schätzen, die zum Beheben dieses Vorfalls erforderlich ist. Der .NET Upgrade Assistant definiert Story-Punktwerte in der folgenden Tabelle:
| Story-Punkte | Größe |
|---|---|
| 1 | Trivial |
| 3 | Komplex |
| 5 | Neugestaltung |
| 7 | Neuarchitektur |
| 13 | Unbekannt |