Verwenden von Sprachstichwörtern anstelle von Frameworktypnamen für Typverweise (IDE0049)

Artikel
02/11/2025

Eigentum	Wert
Regel-ID	IDE0049
Titel	Verwenden von Sprachstichwörtern anstelle von Frameworktypnamen für Typverweise
Kategorie	Stil
Unterkategorie	Sprachregeln (Sprachstichwörter anstelle von Frameworktypnamen)
Anwendbare Sprachen	C# und Visual Basic
Optionen	`dotnet_style_predefined_type_for_locals_parameters_members`
	`dotnet_style_predefined_type_for_member_access`

Überblick

Diese Regel betrifft die Verwendung von Sprachstichwörtern, wo sievorhanden sind, anstelle von Frameworktypnamen.

Anmerkung

Auch wenn Sie Codeformatregeln für den Build aktivieren, ist diese Regel nicht aktiviert. Sie wird nur im Visual Studio-Editor angezeigt.

Optionen

Verwenden Sie die zugehörigen 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

Ein Optionswert von true bedeutet, dass das Sprachschlüsselwort (z. B. int oder Integer) anstelle des Typnamens (z. B. Int32) für Typen bevorzugt wird, die ein Schlüsselwort enthalten, um sie darzustellen. Ein Wert von false bedeutet, dass der Typname anstelle des Schlüsselworts der Sprache bevorzugt wird.

Informationen zum Konfigurieren von Optionen finden Sie unter Option format.

dotnet_style_predefined_type_for_locals_parameters_members

Eigentum	Wert	Beschreibung
Optionenname	dotnet_style_predefined_type_for_locals_parameters_members
Optionswerte	`true`	Bevorzugen Sie das Schlüsselwort der Programmiersprache für lokale Variablen, Methodenparameter und Klassenmitglieder.
	`false`	Bevorzugen Sie den Typnamen für lokale Variablen, Methodenparameter und Klassenmmber.
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

Eigentum	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
Standardoption-Wert	`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

Wenn Sie nur einen einzelnen Verstoß unterdrücken möchten, fügen Sie Ihrer Quelldatei Präprozessordirektiven hinzu, um die Regel zu deaktivieren und dann erneut 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 Konfigurationsdateiauf none fest.

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

Um alle Codestilregeln zu deaktivieren, legen Sie den Schweregrad für die Kategorie Style in der -Konfigurationsdateiauf none fest.

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

Weitere Informationen finden Sie unter So unterdrücken Sie Codeanalysewarnungen.

Freigeben über