Verwenden von Sprachschlüsselwörtern anstelle von Framework-Typnamen für Typverweise (IDE0049)

Artikel
05/07/2024

Eigenschaft	Wert
Regel-ID	IDE0049
Titel	Verwenden von Sprachschlüsselwörtern anstelle von Framework-Typnamen für Typverweise
Kategorie	Stil
Unterkategorie	Sprachregeln (Sprachschlüsselwörter anstelle von Frameworktypnamen)
Gültige Sprachen	C# und Visual Basic
Optionen	`dotnet_style_predefined_type_for_locals_parameters_members`
	`dotnet_style_predefined_type_for_member_access`

Übersicht

Diese Regel betrifft die Verwendung von Sprachschlüsselwörtern, sofern sie vorhanden sind, anstelle von Frameworktypnamen.

Hinweis

Auch wenn Sie Codeformatvorlagenregeln beim Build aktivieren, ist diese Regel nicht aktiviert. Sie wird nur im Visual Studio-Editor angezeigt.

Optionen

Verwenden Sie die zugeordneten Optionen für diese Regel, um sie auf Folgendes anzuwenden:

Lokale Variablen, Methodenparameter und Klassenmember – dotnet_style_predefined_type_for_locals_parameters_members
Typmember-Zugriffsausdrücke – dotnet_style_predefined_type_for_member_access

Wenn der Optionswert auf true festgelegt ist, wird bei Typen, die durch ein Schlüsselwort dargestellt werden, das Sprachschlüsselwort (z. B. int oder Integer) anstelle des Typnamens (z. B. Int32) bevorzugt. Wenn der Wert false festgelegt ist, wird der Typname vor dem Sprachschlüsselwort bevorzugt.

Informationen zum Konfigurieren von Optionen finden Sie unter Optionsformat.

dotnet_style_predefined_type_for_locals_parameters_members

Eigenschaft	Wert	Beschreibung
Name der Option	dotnet_style_predefined_type_for_locals_parameters_members
Optionswerte	`true`	Sprachschlüsselwort für lokale Variablen, Methodenparameter und Klassenmember bevorzugen
	`false`	Typnamen für lokale Variablen, Methodenparameter und Klassenmember bevorzugen
Standardoptionswert	`true`

// dotnet_style_predefined_type_for_locals_parameters_members = true
private int _member;

// dotnet_style_predefined_type_for_locals_parameters_members = false
private Int32 _member;

' dotnet_style_predefined_type_for_locals_parameters_members = true
Private _member As Integer

' dotnet_style_predefined_type_for_locals_parameters_members = false
Private _member As Int32

dotnet_style_predefined_type_for_member_access

Eigenschaft	Wert	Beschreibung
Name der Option	dotnet_style_predefined_type_for_member_access
Optionswerte	`true`	Sprachschlüsselwort für Memberzugriffsausdrücke bevorzugen
	`false`	Typnamen für Memberzugriffsausdrücke bevorzugen
Standardoptionswert	`true`

// dotnet_style_predefined_type_for_member_access = true
var local = int.MaxValue;

// dotnet_style_predefined_type_for_member_access = false
var local = Int32.MaxValue;

' dotnet_style_predefined_type_for_member_access = true
Dim local = Integer.MaxValue

' dotnet_style_predefined_type_for_member_access = false
Dim local = Int32.MaxValue

Unterdrücken einer Warnung

Um nur eine einzelne Verletzung zu unterdrücken, fügen Sie der Quelldatei Präprozessoranweisungen hinzu, um die Regel zu deaktivieren und dann wieder zu aktivieren.

#pragma warning disable IDE0049
// The code that's violating the rule is on this line.
#pragma warning restore IDE0049

Um die Regel für eine Datei, einen Ordner oder ein Projekt zu deaktivieren, legen Sie den Schweregrad in der Konfigurationsdatei auf none fest.

[*.{cs,vb}]
dotnet_diagnostic.IDE0049.severity = none

Um alle Regeln im Code-Stil zu deaktivieren, setzen Sie den Schweregrad für die Kategorie in der KonfigurationsdateiStyle auf none.

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none

Weitere Informationen finden Sie unter Vorgehensweise: Unterdrücken von Codeanalyse-Warnungen.

Teilen über