Använd mönstermatchning (IDE0078 och IDE0260)

Artikel
02/09/2025

Den här artikeln beskriver två relaterade regler, IDE0078 och IDE0260.

Egenskap	Värde
Regel-ID	IDE0078
Rubrik	Använda mönstermatchning
kategori	Stil
underkategori	Språkregler (inställningar för mönstermatchning)
Tillämpliga språk	C# 9.0+
alternativ	`csharp_style_prefer_pattern_matching`

Egenskap	Värde
regel-ID	IDE0260
Rubrik	Använda mönstermatchning
Kategori	Stil
underkategori	Språkregler (inställningar för mönstermatchning)
Tillämpliga språk	C#
alternativ	`csharp_style_pattern_matching_over_as_with_null_check`

Överblick

Den här formatregeln gäller användningen av C# konstruktioner för mönstermatchning.

IDE0260 flaggar specifikt användningen av ett as-uttryck följt av en medlem som läser igenom null-villkorsoperator. Den här regeln liknar IDE0019, som flaggar användningen av ett as-uttryck följt av en null kontroll.

Alternativ

Alternativ anger det beteende som du vill att regeln ska framtvinga. Information om hur du konfigurerar alternativ finns i Alternativformat.

csharp_style_prefer_pattern_matching (IDE0078)

Egenskap	Värde	Beskrivning
Alternativnamn	csharp_style_prefer_pattern_matching
Alternativvärden	`true`	Föredrar att använda mönstermatchningskonstruktioner när det är möjligt
	`false`	Föredrar att inte använda mönstermatchningskonstruktioner.
standardalternativvärde	`true`

csharp_stil_mönsterjämförelse_istället_för_som_med_nullkontroll (IDE0260)

Det här alternativet konfigurerar även regel IDE0019.

Egenskap	Värde	Beskrivning
Alternativnamn	csharp_style_pattern_matching_over_as_with_null_check
Alternativvärden	`true`	Föredrar mönstermatchning framför `as` uttryck med null-villkorlig medlemsåtkomst.
	`false`	Inaktiverar regeln.
standardalternativvärde	`true`

Exempel

IDE0078

// csharp_style_prefer_pattern_matching = true
var x = i is default(int) or > (default(int));
var y = o is not C c;

// csharp_style_prefer_pattern_matching = false
var x = i == default || i > default(int);
var y = !(o is C c);

IDE0260

// Code with violations.
object? o = null;
if ((o as string)?.Length == 0)
{
}

// Fixed code (csharp_style_pattern_matching_over_as_with_null_check = true).
object? o = null;
if (o is string { Length: 0 })
{
}

Undertryck en varning

Om du bara vill förhindra en enda överträdelse lägger du till förprocessordirektiv i källfilen för att inaktivera och återaktiverar sedan regeln.

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

Om du vill inaktivera regeln för en fil, mapp eller ett projekt anger du dess allvarlighetsgrad till none i konfigurationsfilen.

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

Om du vill inaktivera alla regler i kodformat anger du allvarlighetsgraden för kategorin Style till none i konfigurationsfilen .

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

Mer information finns i Så här utelämnar du kodanalysvarningar.

Dela via