update first-mono-app to .NET 10 by timdeschryver · Pull Request #37104 · dotnet/AspNetCore.Docs

timdeschryver · 2026-05-05T18:25:31Z

Closes #37075
See comments for some more info about the changes.

If required, I can also provide a .NET 11 example (there won't be an impact on this example so far AFAIK).

Additionally, I noticed copilot providing the following feedback, should I also change this?

Several placeholders use angle-bracket style (for example, <port>, <user>, <version_number>, <data_directory_path>) instead of the required brace placeholder style.

Use this pattern for placeholders: {PLACEHOLDER NAME} (uppercase words, spaces allowed inside braces).

Specific bad vs good examples:

Bad: https://localhost:<port>/openapi/v1.json
Good: https://localhost:{PORT}/openapi/v1.json

Bad: C:\Users\<user>\AppData\Local\Programs\mongosh
Good: C:\Users\{USER NAME}\AppData\Local\Programs\mongosh

Bad: C:\Program Files\MongoDB\Server\<version_number>\bin
Good: C:\Program Files\MongoDB\Server\{VERSION NUMBER}\bin

Bad: mongod --dbpath <data_directory_path>
Good: mongod --dbpath {DATA DIRECTORY PATH}

Internal previews

📄 File	🔗 Preview link
aspnetcore/tutorials/first-mongo-app.md	Create a web API with ASP.NET Core and MongoDB

timdeschryver · 2026-05-05T18:27:02Z

+* Federation Gateway
+
+> [!IMPORTANT]
+> [Duende Software](https://duendesoftware.com/) might require you to pay a license fee for production use of Duende Identity Server.


This is the same body, except the migration part.
I can revert this if you want, I just thought it didn't add any value since that was for earlier .NET versions.

Perfect, thanks!

timdeschryver · 2026-05-05T18:27:39Z

+public class BooksService(IOptions<BookStoreDatabaseSettings> bookStoreDatabaseSettings)
+{
+    private readonly IMongoCollection<Book> _booksCollection = new MongoClient(bookStoreDatabaseSettings.Value.ConnectionString)
+        .GetDatabase(bookStoreDatabaseSettings.Value.DatabaseName)
+        .GetCollection<Book>(bookStoreDatabaseSettings.Value.BooksCollectionName);
+// </snippet_ctor>


Updated the example to use a primary constructor.

Great catch!

timdeschryver · 2026-05-05T18:28:42Z

 ## Prerequisites

-* [MongoDB 6.0.5 or later](https://docs.mongodb.com/manual/tutorial/install-mongodb-on-windows/)
+* [MongoDB 8.0.0 or later](https://docs.mongodb.com/manual/tutorial/install-mongodb-on-windows/)


Technically 6.0.5 would still work, but I updated this to the latest version.

Latest stable + supported is good. 8.0.0 is good.

timdeschryver · 2026-05-05T18:29:37Z

 * [ReplaceOneAsync](https://mongodb.github.io/mongo-csharp-driver/2.14/apidocs/html/M_MongoDB_Driver_IMongoCollection_1_ReplaceOneAsync.htm): Replaces the single document matching the provided search criteria with the provided object.

-## Add a controller
+## Create endpoints


I used a MapGroup to group the endpoints.
Because it's a minimal API, I removed the /api prefix from the endpoints.

timdeschryver · 2026-05-05T18:30:48Z

 To satisfy the preceding requirements, make the following changes:

-1. In `Program.cs`, chain the following highlighted code on to the `AddControllers` method call:
+1. In `Program.cs`, add the following highlighted code:


Personally, I think the section "Configure JSON serialization options" doesn't add much value here, and I would suggest to remove it from the article.
That being said, the code is updated to follow the minimal API way of configuring the serialization options.

I think keep the "Configure JSON serialization options" section for these two reasons:

Common real-world need: When working with MongoDB, property name mismatches between C# (PascalCase) and JSON (camelCase) are something developers frequently encounter. Showing how to configure JsonOptions and use [JsonPropertyName] is practical.

The minimal API approach is different enough to be worth showing.

That said, it could be condensed a bit.

Your update looks good to me, thanks!

timdeschryver · 2026-05-05T18:31:12Z

   The `[JsonPropertyName]` attribute's value of `Name` represents the property name in the web API's serialized JSON response.

-1. Add the following code to the top of `Models/Book.cs` to resolve the `[JsonProperty]` attribute reference:
+1. Add the following code to the top of `Models/Book.cs` to resolve the `[JsonPropertyName]` attribute reference:


Copilot pointed out this should be JsonPropertyName, I also updated the v9 version.

timdeschryver · 2026-05-05T18:32:33Z


 The app uses the OpenAPI document generated by OpenApi, located at `/openapi/v1.json`, to generate the UI.
-View the generated OpenAPI specification for the `WeatherForecast` API while the project is running by navigating to `https://localhost:<port>/openapi/v1.json` in your browser.
+View the generated OpenAPI specification for the `BookStoreApi` API while the project is running by navigating to `https://localhost:<port>/openapi/v1.json` in your browser.


Copilot pointed out that there's an outdated reference to WeatherForecast. This is also updated in the v9 version.

timdeschryver · 2026-05-05T18:33:15Z

 * <xref:web-api/index>
 * <xref:web-api/action-return-types>
-* [Create a web API with ASP.NET Core](/training/modules/build-web-api-aspnet-core/)
+* [Create a web API with ASP.NET Core](/training/modules/interact-api/)


This was the closest training module I could find to minimal api's.

wadepickett · 2026-05-05T20:00:34Z

@timdeschryver, thanks again for taking this on!

For the question on brackets for placeholders. Yes, this below is the latest guildeline to follow:
Use this pattern for placeholders: {PLACEHOLDER NAME} (uppercase words, spaces allowed inside braces).
Bad: https://localhost:/openapi/v1.json
Good: https://localhost:{PORT}/openapi/v1.json

For .NET 11: if you would like to provide a .NET 11 version that sounds great. Not required though! I don't think there would be much of a difference at all, but .NET 11 and VS are still a potential moving target until the release.

At the moment the only articles we are actively updating are ones effected by .NET 11 related features or feature changes that need to be represented as a priority.

wadepickett · 2026-05-05T20:39:45Z

Code snippets links for v9 are resulting in build errors:
Line 168: [Warning] The code snippet "first-mongo-app/samples_snapshot/9.x/Book.cs" could not be found.

update first-mono-app to .NET 10

1f99dc6

timdeschryver commented May 5, 2026

View reviewed changes

reword to minimal web api

5ead0f3

Conversation

timdeschryver commented May 5, 2026 • edited by github-actions Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Internal previews

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

wadepickett May 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

wadepickett commented May 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

wadepickett commented May 5, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

timdeschryver commented May 5, 2026 •

edited by github-actions Bot

Loading

wadepickett May 5, 2026 •

edited

Loading

wadepickett commented May 5, 2026 •

edited

Loading