匿名類型提供了一種方便的方法,可用來將一組只讀屬性封裝到單個對象中,而無需首先顯式定義一個類型。 類型名由編譯器生成,並且不能在源代碼級使用。 每個屬性的類型由編譯器推斷。
可通過使用 new 運算符和對象初始值創建匿名類型。 有關對象初始值設定項的詳細信息,請參閱對象和集合初始值設定項(C# 編程指南)。
以下示例顯示了用兩個名為 Amount 和 Message 的屬性進行初始化的匿名類型。
var v = new { Amount = 108, Message = "Hello" }; // Rest the mouse pointer over v.Amount and v.Message in the following // statement to verify that their inferred types are int and string. Console.WriteLine(v.Amount + v.Message);
匿名類型通常用在查詢表達式的 select 子句中,以便返回源序列中每個對象的屬性子集。 有關查詢的詳細信息,請參閱LINQ 查詢表達式(C# 編程指南)。
匿名類型包含一個或多個公共只讀屬性。 包含其他種類的類成員(如方法或事件)為無效。 用來初始化屬性的表達式不能為 null、匿名函數或指針類型。
最常見的方案是用其他類型的屬性初始化匿名類型。 在下面的示例中,假定名為 Product 的類存在。 類 Product 包括 Color 和 Price 屬性,以及你不感興趣的其他屬性。 變量products 是 Product 對象的集合。 匿名類型聲明以 new 關鍵字開始。 聲明初始化了一個只使用 Product 的兩個屬性的新類型。 這將導致在查詢中返回較少數量的數據。
如果你沒有在匿名類型中指定成員名稱,編譯器會為匿名類型成員指定與用於初始化這些成員的屬性相同的名稱。 必須為使用表達式初始化的屬性提供名稱,如下面的示例所示。在下面示例中,匿名類型的屬性名稱都為 Color 和 Price。
var productQuery = from prod in products select new { prod.Color, prod.Price }; foreach (var v in productQuery) { Console.WriteLine("Color={0}, Price={1}", v.Color, v.Price); }
通常,當你使用匿名類型來初始化變量時,可以通過使用 var 將變量作為隱式鍵入的本地變來變量進行聲明。 類型名稱無法在變量聲明中給出,因為只有編譯器能訪問匿名類型的基礎名稱。 有關 var的詳細信息,請參閱隱式類型的局部變量(C# 編程指南)。
可通過將隱式鍵入的本地變量與隱式鍵入的數組相結合創建匿名鍵入的元素的數組,如下面的示例所示。
var anonArray = new[] { new { name = "apple", diam = 4 }, new { name = "grape", diam = 1 }};
匿名類型是直接從對象派生的類類型,並且其無法強制轉換為除對象外的任意類型。 雖然你的應用程序不能訪問它,編譯器還是提供了每一個匿名類型的名稱。 從公共語言運行時的角度來看,匿名類型與任何其他引用類型沒有什么不同。
如果程序集中的兩個或多個匿名對象初始值指定了屬性序列,這些屬性采用相同順序且具有相同的名稱和類型,則編譯器將對象視為相同類型的實例。 它們共享同一編譯器生成的類型信息。
無法將字段、屬性、時間或方法的返回類型聲明為具有匿名類型。 同樣,你不能將方法、屬性、構造函數或索引器的形參聲明為具有匿名類型。 要將匿名類型或包含匿名類型的集合作為參數傳遞給某一方法,可將參數作為類型對象進行聲明。 但是,這樣做會使強類型化作用無效。 如果必須存儲查詢結果或者必須將查詢結果傳遞到方法邊界外部,請考慮使用普通的命名結構或類而不是匿名類型。
由於匿名類型上的 Equals 和 GetHashCode 方法是根據方法屬性的 Equals 和 GetHashCode 定義的,因此僅當同一匿名類型的兩個實例的所有屬性都相等時,這兩個實例才相等。