Minimal API responses.md: add missing IBindableFromHttpContext section (#35999)

* Minimal API responces.md add missing IBindableFromHttpContext secton

* Added more code samples and intros

* Fixed code link

* Update aspnetcore/fundamentals/minimal-apis/includes/responses7-8.md

Fixed typo on code link

* Moved to parameter-binding

* Removed extra line space

* Moved new section to after BindAsync and added to intro

* Fixed code link

* Removed v8-9 app sample and inlcudes since they are dupes

* Corrected links to parameter-binding8-10.md

* Fixed one more link to parmeter-binding8-10.md

* Apply suggestion from @Copilot

Co-authored-by: Copilot <[email protected]>

* Apply suggestion from @Copilot

Co-authored-by: Copilot <[email protected]>

* Apply suggestion from @Copilot

Co-authored-by: Copilot <[email protected]>

* Apply suggestion from @Copilot

Co-authored-by: Copilot <[email protected]>

* Apply suggestion from @Copilot

Co-authored-by: Copilot <[email protected]>

---------

Co-authored-by: Copilot <[email protected]>

Author: wadepickett

aspnetcore/fundamentals/minimal-apis.md

@@ -68,7 +68,7 @@ The <xref:System.Delegate> arguments passed to these methods are called "route h
 
 ## Parameter binding
 
-[!INCLUDE [](~/fundamentals/minimal-apis/includes/parameter-binding10.md)]
+[!INCLUDE [](~/fundamentals/minimal-apis/includes/parameter-binding8-10.md)]
 
 ## Json+PipeReader deserialization in minimal APIs
 

aspnetcore/fundamentals/minimal-apis/10.0-samples/CustomBindingExample/CustomBindingExample.csproj

@@ -0,0 +1,9 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+  </PropertyGroup>
+
+</Project>

aspnetcore/fundamentals/minimal-apis/10.0-samples/CustomBindingExample/CustomBoundParameters.cs

@@ -0,0 +1,26 @@
+using System.Reflection;
+
+namespace CustomBindingExample;
+
+public class CustomBoundParameter : IBindableFromHttpContext<CustomBoundParameter>
+{
+    public string Value { get; init; } = default!;
+
+    public static ValueTask<CustomBoundParameter?> BindAsync(HttpContext context, ParameterInfo parameter)
+    {
+        // Custom binding logic here
+        // This example reads from a custom header
+        var value = context.Request.Headers["X-Custom-Header"].ToString();
+        
+        // If no header was provided, you could fall back to a query parameter
+        if (string.IsNullOrEmpty(value))
+        {
+            value = context.Request.Query["customValue"].ToString();
+        }
+        
+        return ValueTask.FromResult<CustomBoundParameter?>(new CustomBoundParameter 
+        {
+            Value = value
+        });
+    }
+}

aspnetcore/fundamentals/minimal-apis/10.0-samples/CustomBindingExample/Program.cs

@@ -0,0 +1,34 @@
+
+// <snippet_IBindableFromHttpContext>
+using CustomBindingExample;
+
+var builder = WebApplication.CreateBuilder(args);
+var app = builder.Build();
+
+app.UseHttpsRedirection();
+
+app.MapGet("/", () => "Hello, IBindableFromHttpContext example!");
+
+app.MapGet("/custom-binding", (CustomBoundParameter param) =>
+{
+    return $"Value from custom binding: {param.Value}";
+});
+
+app.MapGet("/combined/{id}", (int id, CustomBoundParameter param) =>
+{
+    return $"ID: {id}, Custom Value: {param.Value}";
+});
+// </snippet_IBindableFromHttpContext>
+// <snippet_validation>
+app.MapGet("/validated", (ValidatedParameter param) =>
+{
+    if (string.IsNullOrEmpty(param.Value))
+    {
+        return Results.BadRequest("Value cannot be empty");
+    }
+    
+    return Results.Ok($"Validated value: {param.Value}");
+});
+// </snippet_validation>
+
+app.Run();

aspnetcore/fundamentals/minimal-apis/10.0-samples/CustomBindingExample/TestCustomBindingExample.http

@@ -0,0 +1,23 @@
+@host = https://localhost:7176
+
+### Test the root endpoint
+GET {{host}}/
+Accept: text/plain
+
+### Test the custom binding endpoint
+GET {{host}}/custom-binding
+X-Custom-Header: TestHeaderValue
+Accept: text/plain
+
+### Test the combined parameter endpoint
+GET {{host}}/combined/42
+X-Custom-Header: TestHeaderValue
+Accept: text/plain
+
+### Test the validated parameter endpoint - valid case
+GET {{host}}/validated?value=ValidValue
+Accept: text/plain
+
+### Test the validated parameter endpoint - invalid case
+GET {{host}}/validated
+Accept: text/plain

aspnetcore/fundamentals/minimal-apis/10.0-samples/CustomBindingExample/ValidatedParameters.cs

@@ -0,0 +1,29 @@
+using System.Reflection;
+
+namespace CustomBindingExample;
+
+public class ValidatedParameter : IBindableFromHttpContext<ValidatedParameter>
+{
+    public string Value { get; init; } = default!;
+
+    public static ValueTask<ValidatedParameter?> BindAsync(HttpContext context, ParameterInfo parameter)
+    {
+        // Get the value from a query parameter
+        var value = context.Request.Query["value"].ToString();
+        
+        // Perform some basic validation here
+        if (string.IsNullOrEmpty(value))
+        {
+            // Return an empty instance - the route handler will handle the validation failure
+            return ValueTask.FromResult<ValidatedParameter?>(new ValidatedParameter
+            {
+                Value = string.Empty
+            });
+        }
+        
+        return ValueTask.FromResult<ValidatedParameter?>(new ValidatedParameter
+        {
+            Value = value
+        });
+    }
+}

aspnetcore/fundamentals/minimal-apis/10.0-samples/CustomBindingExample/appsettings.Development.json

@@ -0,0 +1,8 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  }
+}

aspnetcore/fundamentals/minimal-apis/10.0-samples/CustomBindingExample/appsettings.json

@@ -0,0 +1,9 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  },
+  "AllowedHosts": "*"
+}

aspnetcore/fundamentals/minimal-apis/7.0-samples/CustomBindingExample/CustomBindingExample.cs

@@ -0,0 +1,9 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>net7.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+  </PropertyGroup>
+
+</Project>

aspnetcore/fundamentals/minimal-apis/7.0-samples/CustomBindingExample/CustomBoundParameters.cs

@@ -0,0 +1,26 @@
+using System.Reflection;
+
+namespace CustomBindingExample;
+
+public class CustomBoundParameter : IBindableFromHttpContext<CustomBoundParameter>
+{
+    public string Value { get; init; } = default!;
+
+    public static ValueTask<CustomBoundParameter?> BindAsync(HttpContext context, ParameterInfo parameter)
+    {
+        // Custom binding logic here
+        // This example reads from a custom header
+        var value = context.Request.Headers["X-Custom-Header"].ToString();
+        
+        // If no header was provided, you could fall back to a query parameter
+        if (string.IsNullOrEmpty(value))
+        {
+            value = context.Request.Query["customValue"].ToString();
+        }
+        
+        return ValueTask.FromResult<CustomBoundParameter?>(new CustomBoundParameter 
+        {
+            Value = value
+        });
+    }
+}