匿名型のインスタンスの宣言では、型のプロパティを指定する初期化子リストを使用します。匿名型の宣言時には、プロパティだけを指定でき、メソッドやイベントなどのその他のクラス要素は指定できません。次の例の product1 は、Name と Price という 2 つのプロパティを持つ匿名型のインスタンスです。

' Variable product1 is an instance of a simple anonymous type.
Dim product1 = New With {.Name = "paperclips", .Price = 1.29}
' -or-
' product2 is an instance of an anonymous type with key properties.
Dim product2 = New With {Key .Name = "paperclips", Key .Price = 1.29}

プロパティを主要なプロパティとして指定した場合は、それらのプロパティを使用して、2 つの匿名型のインスタンスの等価性を比較できます。ただし、主要なプロパティの値は変更できません。詳細については、このトピックで後述する「主要なプロパティ」のセクションを参照してください。

匿名型のインスタンスの宣言は、オブジェクト初期化子による名前付きの型のインスタンスの宣言に似ています。

' Variable product3 is an instance of a class named Product.
Dim product3 = New Product With {.Name = "paperclips", .Price = 1.29}

名前付きの型と匿名型の宣言の詳細な比較については、「名前付きの型と匿名型の比較」を参照してください。

匿名型のプロパティを指定する他の方法の詳細については、「方法 : 匿名型の宣言におけるプロパティ名と型を推論する」を参照してください。

主要なプロパティは、次に示す点で、主要ではないプロパティとは根本的に異なります。

• 2 つのインスタンスが等価かどうかを決定する際は、主要なプロパティの値だけが比較されます。

• 主要なプロパティの値は読み取り専用であり、変更できません。

• 主要なプロパティの値だけが、コンパイラによって生成される匿名型用のハッシュ コードのアルゴリズムに含まれます。

等価比較

' prod1 and prod2 have no key values.
Dim prod1 = New With {.Name = "paperclips", .Price = 1.29}
Dim prod2 = New With {.Name = "paperclips", .Price = 1.29}

' The following line displays False, because prod1 and prod2 have no
' key properties.
Console.WriteLine(prod1.Equals(prod2))

' The following statement displays True because prod1 is equal to itself.
Console.WriteLine(prod1.Equals(prod1))

Dim prod3 = New With {Key .Name = "paperclips", Key .Price = 1.29}
Dim prod4 = New With {Key .Name = "paperclips", Key .Price = 1.29}
' The following line displays True, because prod3 and prod4 are
' instances of the same anonymous type, and the values of their
' key properties are equal.
Console.WriteLine(prod3.Equals(prod4))

Dim prod5 = New With {Key .Name = "paperclips", Key .Price = 1.29}
Dim prod6 = New With {Key .Name = "paperclips", Key .Price = 1.29, _
                      .OnHand = 423}
' The following line displays False, because prod5 and prod6 do not 
' have the same properties.
Console.WriteLine(prod5.Equals(prod6))

Dim prod7 = New With {Key .Name = "paperclips", Key .Price = 1.29, _
                      .OnHand = 24}
Dim prod8 = New With {Key .Name = "paperclips", Key .Price = 1.29, _
                      .OnHand = 423}
' The following line displays True, because prod7 and prod8 are
' instances of the same anonymous type, and the values of their
' key properties are equal. The equality check does not compare the
' values of the non-key field.
Console.WriteLine(prod7.Equals(prod8))

読み取り専用値

' The following statement will not compile, because Name is a key
' property and its value cannot be changed.
' prod8.Name = "clamps"

' OnHand is not a Key property. Its value can be changed.
prod8.OnHand = 22

クエリ式では、常に匿名型を作成する必要があるわけではありません。可能な場合は、既存の型を使用して列データを保持します。これは、クエリでデータ ソースからレコード全体が返された、または各レコードから 1 つのフィールドだけが返された場合に発生します。次のコード例では、customers は、Customer クラスのオブジェクトのコレクションです。このクラスには多くのプロパティがあり、その中の 1 つ以上を、任意の順序でクエリ結果に含めることができます。最初の 2 つの例では、クエリで名前付きの型の要素が選択されるため、匿名型は必要ありません。

• cust.Name が文字列なので、custs1 には文字列のコレクションが格納されます。

  Visual Basic

  Dim custs1 = From cust In customers _
               Select cust.Name
  
  

• customers の各要素は Customer オブジェクトであり、クエリによって要素全体が選択されたので、custs2 には Customer オブジェクトのコレクションが格納されます。

  Visual Basic

  Dim custs2 = From cust In customers _
               Select cust
  
  

ただし、適切な名前付きの型を常に使用できるとは限りません。ある目的のために顧客と住所を、別の目的で顧客 ID と所在地を、さらに別の目的で顧客名、住所、および注文履歴を選択する必要があるとします。匿名型を使用すると、結果を保持するための新しい名前付きの型を先に宣言しなくても、任意のプロパティを任意の順序で組み合わせて選択できます。プロパティのコンパイルのたびに、コンパイラによって匿名型が作成されます。次のクエリでは、customers 内の各 Customer オブジェクトから、顧客の名前と ID 番号だけを選択します。したがって、コンパイラは、これら 2 つのプロパティだけを格納する匿名型を作成します。

Dim custs3 = From cust In customers _
             Select cust.Name, cust.ID

匿名型のプロパティの名前とデータ型は、両方とも、Select の引数である cust.Name と cust.ID から取得されます。クエリによって作成される匿名型のプロパティは、常に主要なプロパティになります。次の For Each ループの中で custs3 が実行された場合、結果は、Name と ID という 2 つの主要なプロパティを持つ匿名型のインスタンスのコレクションになります。

For Each selectedCust In custs3
    Console.WriteLine(selectedCust.ID & ": " & selectedCust.Name)
Next

custs3 で表されるコレクション内の要素は厳密に型指定されるので、IntelliSense を使用して、使用可能なプロパティのナビゲーションとそれらの型の検証を実行できます。

詳細については、「Visual Basic における LINQ の概要」を参照してください。

オブジェクトを匿名クラスのインスタンスとして作成する前に、それが最善の選択肢かどうかを考慮します。たとえば、関連するデータを格納する一時的なオブジェクトを作成するときに、クラス全体に格納されている可能性があるその他のフィールドやメソッドを必要としない場合、匿名型は適切なソリューションです。宣言ごとに異なるプロパティを選択する、またはプロパティの順序を変更する場合にも、匿名型は便利です。ただし、プロジェクトに、固定された順序の同じプロパティを持つ複数のオブジェクトが含まれている場合は、クラス コンストラクタと名前付きの型を使用する方が簡単に宣言できます。たとえば、適切なコンストラクタを使用すると、Product クラスの複数のインスタンスの宣言は、匿名型の複数のインスタンスの宣言より簡単です。

' Declaring instances of a named type.
Dim firstProd1 As New Product("paperclips", 1.29)
Dim secondProd1 As New Product("desklamp", 28.99)
Dim thirdProd1 As New Product("stapler", 5.09)

' Declaring instances of an anonymous type.
Dim firstProd2 = New With {Key .Name = "paperclips", Key .Price = 1.29}
Dim secondProd2 = New With {Key .Name = "desklamp", Key .Price = 28.99}
Dim thirdProd2 = New With {Key .Name = "stapler", Key .Price = 5.09}

名前付きの型で有利なもう 1 つの点は、プロパティ名のタイプミスをコンパイラが検出できることです。前の例では、firstProd2、secondProd2、および thirdProd2 は、同じ匿名型のインスタンスであることを意図しています。ただし、thirdProd2 を次のいずれかの方法で誤って宣言した場合、その型は、firstProd2 および secondProd2 の型と一致しなくなります。

' Dim thirdProd2 = New With {Key .Nmae = "stapler", Key .Price = 5.09}
' Dim thirdProd2 = New With {Key .Name = "stapler", Key .Price = "5.09"}
' Dim thirdProd2 = New With {Key .Name = "stapler", .Price = 5.09}

さらに重要なのは、匿名型の使用に関しては、名前付きの型には適用されない制約があることです。firstProd2、secondProd2、および thirdProd2 は、同じ匿名型のインスタンスです。ただし、共有される匿名型の名前は、コード内で型名が必要とされる場所には使用不可であり、記述できません。たとえば、匿名型を使用してメソッド シグネチャを定義したり、別の変数またはフィールドを宣言したりすることはできません。また、型宣言の中では匿名型を使用できません。結果として、匿名型は、メソッド間で情報を共有する必要がある場合には適していません。

コンパイラは、匿名型のインスタンスの宣言に応答して、指定されたプロパティを含む新しいクラス定義を作成します。

匿名型に、少なくとも 1 つの主要なプロパティが含まれている場合、定義は、Object から継承された 3 つのメンバ (Equals、GetHashCode、および ToString) をオーバーライドします。等価性をテストし、ハッシュ コード値を決定するために生成されるコードは、主要なプロパティだけを考慮します。匿名型に主要なプロパティが含まれていない場合は、ToString だけがオーバーライドされます。明示的に名前を付けられた匿名型のプロパティは、これらの生成されるメソッドと競合することはできません。つまり、.Equals、.GetHashCode、または .ToString を使用してプロパティに名前を付けることはできません。

少なくとも 1 つの主要なプロパティを持つ匿名型の定義は、System..::.IEquatable<(Of <(T>)>) インターフェイスも実装します (T は匿名型の型です)。

コンパイラによって作成されるコードと、オーバーライドされたメソッドの機能については、「匿名型の定義」を参照してください。

処理手順

概念

参照