Missing docs and example on object initializer that lacks a new keyword

[AArnott]

From C# ecma spec 12.7.11.3 it is possible to initialize values into a member using a = { } syntax (note the lack of the new keyword). By this it's possible to initialize a new object deeply within its properties that may not even make a setter available. This is very interesting and useful, and should be documented here.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: d5121576-832f-dba0-f489-ba17c1891161
• Version Independent ID: 0ffb923c-a49c-ed59-abb6-9618aea5df61
• Content: How to: Initialize Objects by Using an Object Initializer - C# Programming Guide
• Content Source: docs/csharp/programming-guide/classes-and-structs/how-to-initialize-objects-by-using-an-object-initializer.md
• Product: dotnet-csharp
• GitHub Login: @BillWagner
• Microsoft Alias: wiwagn

[BillWagner]

Thanks for writing this up @AArnott

I’ve added it to our backlog to update when we next update this topic.

[dotnet-bot]

This issue has been closed as part of the issue backlog grooming process outlined in #22351.

That automated process may have closed some issues that should be addressed. If you think this is one of them, reopen it with a comment explaining why. Tag the @dotnet/docs team for visibility.

[AArnott]

This feature is a gem in the C# language that really should be made known, and otherwise isn't documented anywhere that I can find.

[akamud]

I was losing my mind over this until I found this issue.

ReSharper suggested I'd do this in a code I was writing and I thought to myself: I have never seen this before, is this new? I couldn't figure out how I've never seen this with more than 10 years working with C# and just couldn't understand what was this, specially when I read through the object initializer docs and didn't find any mention to this either.

Is this being worked on?

[ProTip]

After discovering this worked in Rider I spent well over an hour Googling and re-reading the documentation trying to figure out why it worked and where it was documented.