Add IFormFile binding information to minimal APIs documentation

aspnetcore/fundamentals/minimal-apis.md

@@ -5,7 +5,7 @@ description: Provides an overview of Minimal APIs in ASP.NET Core
 ms.author: wpickett
 content_well_notification: AI-contribution
 monikerRange: '>= aspnetcore-6.0'
-ms.date: 09/08/2025
+ms.date: 09/30/2025
 uid: fundamentals/minimal-apis
 ai-usage: ai-assisted
 ---

aspnetcore/fundamentals/minimal-apis/includes/parameter-binding10.md

@@ -186,6 +186,8 @@ The following code shows the complete `Program.cs` file:
 
 #### File uploads using IFormFile and IFormFileCollection
 
+File uploads using `IFormFile` and `IFormFileCollection` in minimal APIs require `multipart/form-data` encoding. The parameter name in the route handler must match the form field name in the request. Minimal APIs don't support binding the entire request body directly to an `IFormFile` parameter without form encoding.
+
 The following code uses <xref:Microsoft.AspNetCore.Http.IFormFile> and <xref:Microsoft.AspNetCore.Http.IFormFileCollection> to upload file:
 
 :::code language="csharp" source="~/fundamentals/minimal-apis/iformFile/7.0-samples/MinimalApi/Program.cs" :::

aspnetcore/fundamentals/minimal-apis/includes/parameter-binding7.md

@@ -162,6 +162,8 @@ The following code shows the complete `Program.cs` file:
 
 #### File uploads using IFormFile and IFormFileCollection
 
+File uploads using `IFormFile` and `IFormFileCollection` in minimal APIs require `multipart/form-data` encoding. The parameter name in the route handler must match the form field name in the request. Minimal APIs don't support binding the entire request body directly to an `IFormFile` parameter without form encoding.
+
 The following code uses <xref:Microsoft.AspNetCore.Http.IFormFile> and <xref:Microsoft.AspNetCore.Http.IFormFileCollection> to upload file:
 
 :::code language="csharp" source="~/fundamentals/minimal-apis/iformFile/7.0-samples/MinimalApi/Program.cs" :::

aspnetcore/fundamentals/minimal-apis/includes/parameter-binding8.md

@@ -186,6 +186,8 @@ The following code shows the complete `Program.cs` file:
 
 #### File uploads using IFormFile and IFormFileCollection
 
+File uploads using `IFormFile` and `IFormFileCollection` in minimal APIs require `multipart/form-data` encoding. The parameter name in the route handler must match the form field name in the request. Minimal APIs don't support binding the entire request body directly to an `IFormFile` parameter without form encoding.
+
 The following code uses <xref:Microsoft.AspNetCore.Http.IFormFile> and <xref:Microsoft.AspNetCore.Http.IFormFileCollection> to upload file:
 
 :::code language="csharp" source="~/fundamentals/minimal-apis/iformFile/7.0-samples/MinimalApi/Program.cs" :::

aspnetcore/fundamentals/minimal-apis/includes/parameter-binding9.md

@@ -186,6 +186,8 @@ The following code shows the complete `Program.cs` file:
 
 #### File uploads using IFormFile and IFormFileCollection
 
+File uploads using `IFormFile` and `IFormFileCollection` in minimal APIs require `multipart/form-data` encoding. The parameter name in the route handler must match the form field name in the request. Minimal APIs don't support binding the entire request body directly to an `IFormFile` parameter without form encoding.
+
 The following code uses <xref:Microsoft.AspNetCore.Http.IFormFile> and <xref:Microsoft.AspNetCore.Http.IFormFileCollection> to upload file:
 
 :::code language="csharp" source="~/fundamentals/minimal-apis/iformFile/7.0-samples/MinimalApi/Program.cs" :::