Add gRPC client and server sample for ASP.NET Core 10 (#36732)

* Add gRPC client and server sample for ASP.NET Core 10

* fix the reference to vs-10

* Apply suggestions from code review

Co-authored-by: Wade Pickett <wpickett@microsoft.com>

---------

Co-authored-by: Wade Pickett <wpickett@microsoft.com>

Author: timdeschryver

aspnetcore/includes/run-the-app10.0.md

@@ -0,0 +1,29 @@
+# [Visual Studio](#tab/visual-studio)
+
+* Press Ctrl+F5 to run without the debugger.
+
+  [!INCLUDE[](~/includes/trustCertVS26.md)]
+
+  Visual Studio:
+
+  * Starts [Kestrel](xref:fundamentals/servers/index#kestrel) server.
+  * Launches a browser.
+  * Navigates to `http://localhost:port`, such as `http://localhost:7042`.
+    * *port*: A randomly assigned port number for the app.
+    * `localhost`: The standard hostname for the local computer. Localhost only serves web requests from the local computer.
+
+# [Visual Studio Code](#tab/visual-studio-code)
+
+  [!INCLUDE[](~/includes/trustCertVSC.md)]
+
+* Press **Ctrl-F5** to run without the debugger.
+
+  Visual Studio Code:
+
+  * Starts [Kestrel](xref:fundamentals/servers/index#kestrel) server.
+  * Launches a browser.
+  * Navigates to `http://localhost:port`, such as `http://localhost:7042`.
+    * *port*: A randomly assigned port number for the app.
+    * `localhost`: The standard hostname for the local computer. Localhost only serves web requests from the local computer.
+
+---

aspnetcore/includes/trustCertVS26.md

@@ -0,0 +1,13 @@
+Visual Studio displays the following dialog:
+
+![This project is configured to use SSL. To avoid SSL warnings in the browser you can choose to trust the self-signed certificate that IIS Express has generated. Would you like to trust the IIS Express SSL certificate?](~/static/trustCertVS26.png)
+
+Select **Yes** if you trust the IIS Express SSL certificate.
+
+The following dialog is displayed:
+
+![Security warning dialog](~/static/certVS26.png)
+
+Select **Yes** if you agree to trust the development certificate.
+
+[!INCLUDE[trust FF](~/includes/trust-ff.md)]

aspnetcore/static/certVS26.png

@@ -4,12 +4,12 @@ author: jamesnk
 description: This tutorial shows how to create a gRPC Service and gRPC client on ASP.NET Core. Learn how to create a gRPC Service project, edit a proto file, and add a duplex streaming call.
 monikerRange: '>= aspnetcore-3.0'
 ms.author: wpickett
-ms.date: 01/30/2025
+ms.date: 02/02/2026
 uid: tutorials/grpc/grpc-start
 ---
 # Tutorial: Create a gRPC client and server in ASP.NET Core
 
-:::moniker range=">= aspnetcore-9.0"
+:::moniker range=">= aspnetcore-10.0"
 This tutorial shows how to create a .NET [gRPC](xref:grpc/index) client and an ASP.NET Core gRPC Server. At the end, you'll have a gRPC client that communicates with the gRPC Greeter service.
 
 In this tutorial, you:
@@ -23,23 +23,23 @@ In this tutorial, you:
 
 # [Visual Studio](#tab/visual-studio)
 
-[!INCLUDE[](~/includes/net-prereqs-vs-9.0.md)]
+[!INCLUDE[](~/includes/net-prereqs-vs-10.md)]
 
 # [Visual Studio Code](#tab/visual-studio-code)
 
-[!INCLUDE[](~/includes/net-prereqs-vsc-9.0.md)]
+[!INCLUDE[](~/includes/net-prereqs-vsc-10.0.md)]
 
 ---
 
 ## Create a gRPC service
 
 # [Visual Studio](#tab/visual-studio)
 
-* Start Visual Studio 2022 and select **New Project**.
+* Start Visual Studio and select **Create a new Project**.
 * In the **Create a new project** dialog, search for `gRPC`. Select **ASP.NET Core gRPC Service** and select **Next**.
 * In the **Configure your new project** dialog, enter `GrpcGreeter` for **Project name**. It's important to name the project *GrpcGreeter* so the namespaces match when you copy and paste code.
 * Select **Next**.
-* In the **Additional information** dialog, select **.NET 9.0 (Standard Term Support)** and then select **Create**.
+* In the **Additional information** dialog, select **.NET 10.0 (Long Term Support)** and then select **Create**.
 
 # [Visual Studio Code](#tab/visual-studio-code)
 
@@ -64,7 +64,7 @@ The tutorial assumes familiarity with VS Code. For more information, see [Gettin
 
 ### Run the service
 
-[!INCLUDE[](~/includes/run-the-app9.0.md)]
+[!INCLUDE[](~/includes/run-the-app10.0.md)]
 
 The logs show the service listening on `https://localhost:<port>`, where `<port>` is the localhost port number randomly assigned when the project is created and set in `Properties/launchSettings.json`.
 
@@ -78,15 +78,15 @@ info: Microsoft.Hosting.Lifetime[0]
 ```
 
 > [!NOTE]
-> The gRPC template is configured to use [Transport Layer Security (TLS)](https://tools.ietf.org/html/rfc5246). gRPC clients need to use HTTPS to call the server.  The gRPC service localhost port number is randomly assigned when the project is created and set in the *Properties\launchSettings.json* file of the gRPC service project.
+> The gRPC template is configured to use [Transport Layer Security (TLS)](https://tools.ietf.org/html/rfc5246). gRPC clients need to use HTTPS to call the server. The gRPC service localhost port number is randomly assigned when the project is created and set in the *Properties\launchSettings.json* file of the gRPC service project.
 
 ### Examine the project files
 
 *GrpcGreeter* project files:
 
 * `Protos/greet.proto`: defines the `Greeter` gRPC and is used to generate the gRPC server assets. For more information, see [Introduction to gRPC](xref:grpc/index).
 * `Services` folder: Contains the implementation of the `Greeter` service.
-* `appSettings.json`: Contains configuration data such as the protocol used by Kestrel. For more information, see <xref:fundamentals/configuration/index>.
+* `appsettings.json`: Contains configuration data such as the protocol used by Kestrel. For more information, see <xref:fundamentals/configuration/index>.
 * `Program.cs`, which contains:
   * The entry point for the gRPC service. For more information, see <xref:fundamentals/host/generic-host>.
   * Code that configures app behavior. For more information, see [App startup](xref:fundamentals/startup).
@@ -95,10 +95,10 @@ info: Microsoft.Hosting.Lifetime[0]
 
 # [Visual Studio](#tab/visual-studio)
 
-* Open a second instance of Visual Studio and select **New Project**.
+* Open a second instance of Visual Studio and select **Create a new project**.
 * In the **Create a new project** dialog, select **Console App**, and select **Next**.
 * In the **Project name** text box, enter **GrpcGreeterClient** and select **Next**.
-* In the **Additional information** dialog, select **.NET 9.0 (Standard Term Support)** and then select **Create**.
+* In the **Additional information** dialog, select **.NET 10.0 (Long Term Support)** and then select **Create**.
 
 # [Visual Studio Code](#tab/visual-studio-code)
 
@@ -203,7 +203,7 @@ dotnet add GrpcGreeterClient.csproj package Grpc.Tools
 
 * Update the gRPC client `Program.cs` file with the following code.
 
-  [!code-csharp[](~/tutorials/grpc/grpc-start/sample/sample9/GrpcGreeterClient/Program.cs?name=snippet2&highlight=5)]
+  [!code-csharp[](~/tutorials/grpc/grpc-start/sample/sample10/GrpcGreeterClient/Program.cs?name=snippet2&highlight=5)]
 
 * In the preceding highlighted code, replace the localhost port number `7042` with the `HTTPS` port number specified in `Properties/launchSettings.json` within the `GrpcGreeter` service project.
 
@@ -214,17 +214,17 @@ The Greeter client is created by:
 * Instantiating a `GrpcChannel` containing the information for creating the connection to the gRPC service.
 * Using the `GrpcChannel` to construct the Greeter client:
 
-[!code-csharp[](~/tutorials/grpc/grpc-start/sample/sample9/GrpcGreeterClient/Program.cs?name=snippet&highlight=1-3)]
+[!code-csharp[](~/tutorials/grpc/grpc-start/sample/sample10/GrpcGreeterClient/Program.cs?name=snippet&highlight=1-3)]
 
 The Greeter client calls the asynchronous `SayHello` method. The result of the `SayHello` call is displayed:
 
-[!code-csharp[](~/tutorials/grpc/grpc-start/sample/sample9/GrpcGreeterClient/Program.cs?name=snippet&highlight=4-6)]
+[!code-csharp[](~/tutorials/grpc/grpc-start/sample/sample10/GrpcGreeterClient/Program.cs?name=snippet&highlight=4-6)]
 
 ## Test the gRPC client with the gRPC Greeter service
 
 Update the `appsettings.Development.json` file by adding the following highlighted lines:
 
-[!code-csharp[](~/tutorials/grpc/grpc-start/sample/sample9/GrpcGreeter/appsettings.Development.json?highlight=6-7)]
+[!code-csharp[](~/tutorials/grpc/grpc-start/sample/sample10/GrpcGreeter/appsettings.Development.json?highlight=6-7)]
 
 # [Visual Studio](#tab/visual-studio)
 
@@ -278,6 +278,8 @@ info: Microsoft.AspNetCore.Hosting.Diagnostics[2]
 
 :::moniker-end
 
+[!INCLUDE[](~/tutorials/grpc/grpc-start/includes/grpc-start9.md)]
+
 [!INCLUDE[](~/tutorials/grpc/grpc-start/includes/grpc-start8.md)]
 
 [!INCLUDE[](~/tutorials/grpc/grpc-start/includes/grpc-start7.md)]