Použijte šíření hodnot null (IDE0031)

Článek
02/09/2025

Vlastnost	Hodnota
Pravidlo ID	IDE0031
název	Použití šíření hodnoty null
kategorie	Styl
podkategorie	Jazyková pravidla (předvolby na úrovni výrazu)
příslušné jazyky	C# a Visual Basic
Možnosti	`dotnet_style_null_propagation`

Přehled

Toto pravidlo stylu se týká použití podmíněného operátoru s hodnotou null a ternárního podmíněného výrazu s kontrolou null.

Možnosti

Nastavte hodnotu přidružené možnosti, abyste určili, zda mají být použity podmíněné operátory s kontrolou na nulové hodnoty nebo ternární podmíněné výrazy.

Další informace o konfiguraci možností naleznete v tématu Formát možnosti.

dotnet_style_null_propagation

Vlastnost	Hodnota	Popis
název možnosti	dotnet_style_null_propagation
hodnoty možností	`true`	Pokud je to možné, raději použijte operátor s podmínkou null.
	`false`	Pokud je to možné, raději používejte kontrolu ternární hodnoty null.
výchozí hodnota možnosti	`true`

// dotnet_style_null_propagation = true
var v = o?.ToString();

// dotnet_style_null_propagation = false
var v = o == null ? null : o.ToString(); // or
var v = o != null ? o.ToString() : null;

' dotnet_style_null_propagation = true
Dim v = o?.ToString()

' dotnet_style_null_propagation = false
Dim v = If(o Is Nothing, Nothing, o.ToString()) ' or
Dim v = If(o IsNot Nothing, o.ToString(), Nothing)

Potlačte upozornění

Pokud chcete potlačit pouze jedno porušení, přidejte do zdrojového souboru direktivy preprocesoru, abyste pravidlo zakázali a znovu povolili.

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

Chcete-li pravidlo pro soubor, složku nebo projekt zakázat, nastavte jeho závažnost na none v konfiguračním souboru .

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

Chcete-li zakázat všechna pravidla stylu kódu, nastavte závažnost pro kategorii Style na none v konfiguračním souboru .

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

Další informace naleznete v tématu Jak potlačit upozornění analýzy kódu.

Viz také

Pravidla stylu programovacího jazyka
Referenční pravidla stylu kódu

Sdílet prostřednictvím