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

この記事では、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

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

関連項目

• var キーワード
• コード スタイルの言語規則
• コード スタイルの規則のリファレンス