MinimalHelpers.Binding 1.0.19

Minimal APIs Binding Helpers

A library that provides Binding helpers for Minimal API projects.

Installation

The library is available on NuGet. Just search MinimalHelpers.Binding in the Package Manager GUI or run the following command in the Package Manager Console:

Install-Package MinimalHelpers.Binding

Usage

IFormFile and IFormFileCollection binding

Use a FormFileContent or FormFileContentCollection argument in the route handler that must receive a single file or a collection of files, then call the corresponding Accepts* extension method on the endpoint definition:

app.MapPost("/api/single-file", (FormFileContent file) =>
{
    return Results.Ok(new
    {
        file.Content.FileName,
        file.Content.ContentType,
        file.Content.Length
    });
})
.AcceptsFormFile();

app.MapPost("/api/multiple-files", (FormFileContentCollection files) =>
{
    return Results.Ok(files.Content.Select(file => new
    {
        file.FileName,
        file.ContentType,
        file.Length
    }));
})
.AcceptsFormFileCollection();

Add the FormFile Operation Filter to Swagger, so that it will be able to correctly handle file input:

builder.Services.AddSwaggerGen(options =>
{
    options.AddFormFile();
});

Contribute

The project is constantly evolving. Contributions are welcome. Feel free to file issues and pull requests on the repo and we'll address them as we can.