var (C# リファレンス)var (C# Reference)

Visual C# 3.0 以降、メソッド スコープで宣言された変数には暗黙的な "型" var を与えることができます。Beginning in Visual C# 3.0, variables that are declared at method scope can have an implicit "type" var. 暗黙的に型指定されたローカル変数では、型を自分で宣言した場合と同様に厳密に型指定されますが、コンパイラが型を決定します。An implicitly typed local variable is strongly typed just as if you had declared the type yourself, but the compiler determines the type. 次の 2 つの i の宣言は機能的に等しくなります。The following two declarations of i are functionally equivalent:

var i = 10; // Implicitly typed.
int i = 10; // Explicitly typed.

詳しくは、「暗黙的に型指定されるローカル変数」および「LINQ クエリ操作での型の関係」をご覧ください。For more information, see Implicitly Typed Local Variables and Type Relationships in LINQ Query Operations.


var を null 許容参照型を有効にして使用すると、式の型で null 値が許容されない場合でも、常に null 値を許容する参照型を表します。When var is used with nullable reference types enabled, it always implies a nullable reference type even if the expression type isn't nullable.


次の例は、2 つのクエリ式を示しています。The following example shows two query expressions. 最初の式では、var の使用が許可されますが、必須ではありません。クエリ結果の型を IEnumerable<string> として明示的に指定できるためです。In the first expression, the use of var is permitted but is not required, because the type of the query result can be stated explicitly as an IEnumerable<string>. 一方、2 つ目の式の var では、匿名型のコレクションとしての結果が許され、その型の名前にはコンパイラ自体以外はアクセスできません。However, in the second expression, var allows the result to be a collection of anonymous types, and the name of that type is not accessible except to the compiler itself. var を使うと、結果のために新しいクラスを作成する必要がなくなります。Use of var eliminates the requirement to create a new class for the result. 例 #2 では、foreach 繰り返し変数 item も暗黙的に型指定する必要があります。Note that in Example #2, the foreach iteration variable item must also be implicitly typed.

// Example #1: var is optional when
// the select clause specifies a string
string[] words = { "apple", "strawberry", "grape", "peach", "banana" };
var wordQuery = from word in words
                where word[0] == 'g'
                select word;

// Because each element in the sequence is a string,
// not an anonymous type, var is optional here also.
foreach (string s in wordQuery)

// Example #2: var is required because
// the select clause specifies an anonymous type
var custQuery = from cust in customers
                where cust.City == "Phoenix"
                select new { cust.Name, cust.Phone };

// var must be used because each item
// in the sequence is an anonymous type
foreach (var item in custQuery)
    Console.WriteLine("Name={0}, Phone={1}", item.Name, item.Phone);

関連項目See also