Meldungen der Include-Bereinigung

In diesem Artikel werden die vom Feature für die Include-Bereinigung generierten Meldungen beschrieben. Weitere Informationen zur Include-Bereinigung finden Sie unter Übersicht über die C/C++-Include-Bereinigung.

Ab 17.8 Preview 1 kann Visual Studio Ihre #includes bereinigen, um die Qualität von C- und C++-Code auf folgende Weise zu verbessern:

• Bietet das Hinzufügen von Headerdateien für Code, der nur kompiliert wird, weil eine erforderliche Headerdatei indirekt von einer anderen Headerdatei eingeschlossen wird.
• Bietet an, nicht verwendete Headerdateien zu entfernen, um Buildzeiten und Codeübersichtlichkeit zu verbessern.

Sie können auswählen, ob Meldungen der Include-Bereinigung in Form von Vorschlägen, Warnungen oder Fehlern im Fenster „Fehlerliste“ angezeigt werden. Weitere Informationen finden Sie unter Konfigurieren der C/C++-Include-Bereinigung in Visual Studio.

Im folgenden Screenshot der Fehlerliste ist die Include-Bereinigung so konfiguriert, dass nicht verwendete Header mit einer Warnung angezeigt werden:

Der Dropdownfilter ist auf „Build und IntelliSense“ festgelegt. Eine Warnung wird angezeigt: „VCIC002 – #include < iostream-> wird in dieser Datei nicht verwendet.“

Die Include-Bereinigung generiert die folgenden Meldungen:

VCIC001: Inhalt aus #include wird in dieser Datei verwendet und transitiv eingeschlossen.

Diese Meldung bedeutet, dass Sie Inhalte aus einer Headerdatei verwenden, die indirekt eingeschlossen wird.

Sie können z. B. direkt eine Headerdatei einschließen, die auch #include <string> enthält. Wenn Sie string in Ihrem Code, aber nicht #include <string> in dieser Datei verwenden, funktioniert dies, solange die andere Headerdatei weiterhin <string> indirekt für Sie einschließt. Diese Meldung ermittelt diese Situation in Ihrem Code, sodass Sie Maßnahmen ergreifen können, um die transitiv eingeschlossene Headerdatei direkt einzuschließen. Weitere Informationen finden Sie unter Direkte und indirekte Header.

VCIC002: #include wird in dieser Datei nicht verwendet.

Diese Meldung bedeutet, dass die angegebene Headerdatei in der aktuellen Datei nicht verwendet wird. Sie können die zugeordnete #include-Anweisung entfernen, um Ihre #include-Anweisungen zu bereinigen und die Buildzeiten zu verbessern.

Siehe auch

Übersicht über die C/C++-Include-Bereinigung
Konfigurieren der C/C++-Include-Bereinigung in Visual Studio