'var' の設定 (IDE0007 および IDE0008)

[アーティクル]
04/07/2023

この記事では、IDE0007 と IDE0008 という 2 つの関連ルールについて説明します。

プロパティ	値
ルール ID	IDE0007
Title	明示的な型の代わりに `var` を使用する
カテゴリ	スタイル
Subcategory	言語ルール ('var' の基本設定)
該当言語	C#
[オプション]	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

プロパティ	値
ルール ID	IDE0008
Title	`var` の代わりに明示的な型を使用する
カテゴリ	スタイル
Subcategory	言語ルール ('var' の基本設定)
該当言語	C#
[オプション]	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

概要

これら 2 つのスタイル規則は、変数宣言で var キーワードまたは明示的な型を使う必要があるかどうかを定義します。 var の使用を強制するには、IDE0007 の重大度を警告またはエラーに設定します。明示的な型の使用を強制するには、IDE0008 の重大度を警告またはエラーに設定します。

オプション

この規則に関連付けられているオプションでは、このスタイル設定を適用する場所を定義します。

組み込み型 (csharp_style_var_for_built_in_types)
型が明らかな場所 (csharp_style_var_when_type_is_apparent)
その他の場所 (csharp_style_var_elsewhere)

オプションの構成の詳細については、「オプションの書式」を参照してください。

csharp_style_var_for_built_in_types

プロパティ	値	説明
オプション名	csharp_style_var_for_built_in_types
オプションの値	`true`	`int` などの組み込みシステム型で変数を宣言するには、`var` を使用します
	`false`	`int` などの組み込みシステム型で変数を宣言するには、`var` ではなく明示的な型を使用します
既定のオプションの値	`false`

// csharp_style_var_for_built_in_types = true
var x = 5;

// csharp_style_var_for_built_in_types = false
int x = 5;

csharp_style_var_when_type_is_apparent

プロパティ	値	説明
オプション名	csharp_style_var_when_type_is_apparent
オプションの値	`true`	宣言式の右側で型が既に示されているときは、`var` を使用します
	`false`	宣言式の右側で型が既に示されているときは、明示的な型を使用します
既定のオプションの値	`false`

// csharp_style_var_when_type_is_apparent = true
var obj = new Customer();

// csharp_style_var_when_type_is_apparent = false
Customer obj = new Customer();

csharp_style_var_elsewhere

プロパティ	値	説明
オプション名	csharp_style_var_elsewhere
オプションの値	`true`	別のコードスタイルルールでオーバーライドされない限り、すべての場合に明示的な型ではなく `var` を使用します
	`false`	別のコードスタイルルールでオーバーライドされない限り、すべての場合に `var` ではなく明示的な型を使用します
既定のオプションの値	`false`

// csharp_style_var_elsewhere = true
var f = this.Init();

// csharp_style_var_elsewhere = false
bool f = this.Init();

警告を抑制する

単一の違反だけを抑制する場合は、ソースファイルにプリプロセッサディレクティブを追加して無効にしてから、規則を再度有効にします。

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

ファイル、フォルダー、またはプロジェクトのルールを無効にするには、構成ファイルでその重要度を none に設定します。

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

すべてのコードスタイル規則を無効にするには、構成ファイルでカテゴリ Style の重要度を none に設定します。

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

詳細については、「コード分析の警告を抑制する方法」を参照してください。

次の方法で共有