Microsoft.Extensions.Configuration.Binder 8.0.0-preview.2.23128.3

About

Provides the functionality to bind an object to data in configuration providers for Microsoft.Extensions.Configuration. This package enables you to represent the configuration data as strongly-typed classes defined in the application code. To bind a configuration, use the Microsoft.Extensions.Configuration.ConfigurationBinder.Get extension method on the IConfiguration object. To use this package, you also need to install a package for the configuration provider, for example, Microsoft.Extensions.Configuration.Json for the JSON provider.

For more information, see the documentation: Configuration in .NET.

Example

The following example shows how to bind a JSON configuration section to .NET objects.

using System;
using Microsoft.Extensions.Configuration;

class Settings
{
    public string Server { get; set; }
    public string Database { get; set; }
    public Endpoint[] Endpoints { get; set; }
}

class Endpoint
{
    public string IPAddress { get; set; }
    public int Port { get; set; }
}

class Program
{
    static void Main()
    {
        // Build a configuration object from JSON file
        IConfiguration config = new ConfigurationBuilder()
            .AddJsonFile("appsettings.json")
            .Build();

        // Bind a configuration section to an instance of Settings class
        Settings settings = config.GetSection("Settings").Get<Settings>();

        // Read simple values
        Console.WriteLine($"Server: {settings.Server}");
        Console.WriteLine($"Database: {settings.Database}");

        // Read nested objects
        Console.WriteLine("Endpoints: ");
        
        foreach (Endpoint endpoint in settings.Endpoints)
        {
            Console.WriteLine($"{endpoint.IPAddress}:{endpoint.Port}");
        }
    }
}

To run this example, include an appsettings.json file with the following content in your project:

{
  "Settings": {
    "Server": "example.com",
    "Database": "Northwind",
    "Endpoints": [
      {
        "IPAddress": "192.168.0.1",
        "Port": "80"
      },
      {
        "IPAddress": "192.168.10.1",
        "Port": "8080"
      }
    ]
  }
}

You can include a configuration file using a code like this in your .csproj file:

<ItemGroup>
  <Content Include="appsettings.json">
    <CopyToOutputDirectory>Always</CopyToOutputDirectory>
  </Content>
</ItemGroup>

Showing the top 20 packages that depend on Microsoft.Extensions.Configuration.Binder.

Packages Downloads
Serilog.Settings.Configuration
Microsoft.Extensions.Configuration (appsettings.json) support for Serilog.
2,361
Microsoft.Extensions.Logging.Configuration
Configuration support for Microsoft.Extensions.Logging.
2,230
OpenTelemetry.Exporter.OpenTelemetryProtocol
OpenTelemetry protocol exporter for OpenTelemetry .NET
2,215
Microsoft.Extensions.Hosting
Hosting and startup infrastructures for applications.
2,194
Microsoft.Extensions.Options.ConfigurationExtensions
Provides additional configuration specific functionality related to Options.
2,185
Microsoft.Extensions.Logging.Configuration
Configuration support for Microsoft.Extensions.Logging.
2,176
Microsoft.Extensions.Logging
Logging infrastructure default implementation for Microsoft.Extensions.Logging.
795
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
174
Microsoft.Extensions.Options.ConfigurationExtensions
Provides additional configuration specific functionality related to Options.
151
Microsoft.Extensions.Logging.Configuration
Configuration support for Microsoft.Extensions.Logging.
151
Microsoft.Extensions.Options.ConfigurationExtensions
Provides additional configuration specific functionality related to Options.
149
Microsoft.Extensions.Logging.Configuration
Configuration support for Microsoft.Extensions.Logging.
120
Microsoft.Extensions.Options.ConfigurationExtensions
Provides additional configuration specific functionality related to Options.
116
Microsoft.Extensions.Hosting
Hosting and startup infrastructures for applications.
109
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
104
Serilog.Settings.Configuration
Microsoft.Extensions.Configuration (appsettings.json) support for Serilog.
99
Sentry.AspNetCore
Official ASP.NET Core integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
97
Microsoft.Extensions.Logging.Configuration
Configuration support for Microsoft.Extensions.Logging.
87
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
86
Microsoft.Extensions.Options.ConfigurationExtensions
Provides additional configuration specific functionality related to Options.
86

.NET Framework 4.6.2

.NET 6.0

.NET 7.0

.NET 8.0

.NET Standard 2.0

Version Downloads Last updated
11.0.0 15 11/12/2026
11.0.0-rc.3.26522.148 16 10/25/2026
11.0.0-rc.2.26504.105 18 10/13/2026
11.0.0-rc.1.26425.128 23 09/09/2026
11.0.0-preview.7.26381.103 36 08/12/2026
11.0.0-preview.6.26359.118 30 07/17/2026
11.0.0-preview.5.26302.115 33 06/11/2026
11.0.0-preview.4.26230.115 39 05/13/2026
11.0.0-preview.3.26207.106 56 04/16/2026
11.0.0-preview.2.26159.112 51 03/11/2026
11.0.0-preview.1.26104.118 50 02/12/2026
10.0.15 9 11/10/2026
10.0.14 19 10/25/2026
10.0.13 30 10/13/2026
10.0.12 24 09/09/2026
10.0.11 168 08/13/2026
10.0.10 32 07/17/2026
10.0.9 28 06/11/2026
10.0.8 40 05/13/2026
10.0.7 2,201 04/23/2026
10.0.6 43 04/16/2026
10.0.5 57 03/14/2026
10.0.4 48 03/12/2026
10.0.3 49 02/12/2026
10.0.2 67 01/15/2026
10.0.1 9 10/07/2026
10.0.0 2,244 12/17/2025
10.0.0-rc.2.25502.107 53 12/17/2025
10.0.0-rc.1.25451.107 51 12/13/2025
10.0.0-preview.7.25380.108 50 12/16/2025
10.0.0-preview.6.25358.103 38 12/19/2025
10.0.0-preview.5.25277.114 40 12/14/2025
10.0.0-preview.4.25258.110 50 12/19/2025
10.0.0-preview.3.25171.5 40 12/28/2025
10.0.0-preview.2.25163.2 42 12/14/2025
10.0.0-preview.1.25080.5 50 12/15/2025
9.0.23 8 11/10/2026
9.0.22 14 10/25/2026
9.0.21 18 10/13/2026
9.0.20 23 09/11/2026
9.0.19 30 08/13/2026
9.0.18 31 07/16/2026
9.0.17 29 06/11/2026
9.0.16 37 05/13/2026
9.0.15 40 04/16/2026
9.0.14 48 03/11/2026
9.0.13 56 02/11/2026
9.0.12 58 01/15/2026
9.0.11 44 12/14/2025
9.0.10 39 12/20/2025
9.0.9 42 12/26/2025
9.0.8 29 12/20/2025
9.0.7 38 12/20/2025
9.0.6 56 12/15/2025
9.0.5 57 12/12/2025
9.0.4 38 12/13/2025
9.0.3 66 12/20/2025
9.0.2 51 12/17/2025
9.0.1 52 12/22/2025
9.0.0 8 09/28/2026
9.0.0-rc.2.24473.5 9 10/05/2026
9.0.0-rc.1.24431.7 36 12/21/2025
9.0.0-preview.7.24405.7 28 12/11/2025
9.0.0-preview.6.24327.7 15 10/05/2026
9.0.0-preview.5.24306.7 58 12/11/2025
9.0.0-preview.4.24266.19 49 12/11/2025
9.0.0-preview.3.24172.9 52 12/11/2025
9.0.0-preview.2.24128.5 43 12/21/2025
9.0.0-preview.1.24080.9 53 12/20/2025
8.0.2 51 09/28/2026
8.0.1 118 12/20/2025
8.0.0 95 09/28/2026
8.0.0-rc.2.23479.6 57 12/20/2025
8.0.0-rc.1.23419.4 5 10/10/2026
8.0.0-preview.7.23375.6 60 12/11/2025
8.0.0-preview.6.23329.7 54 12/20/2025
8.0.0-preview.5.23280.8 10 10/11/2026
8.0.0-preview.4.23259.5 52 12/14/2025
8.0.0-preview.3.23174.8 41 12/12/2025
8.0.0-preview.2.23128.3 43 12/14/2025
8.0.0-preview.1.23110.8 49 12/15/2025
7.0.4 46 12/20/2025
7.0.3 51 12/15/2025
7.0.2 52 12/14/2025
7.0.1 38 01/06/2026
7.0.0 62 12/12/2025
7.0.0-rc.2.22472.3 43 12/14/2025
7.0.0-rc.1.22426.10 44 01/02/2026
7.0.0-preview.7.22375.6 15 09/28/2026
7.0.0-preview.6.22324.4 33 12/11/2025
7.0.0-preview.5.22301.12 36 01/03/2026
7.0.0-preview.4.22229.4 44 12/15/2025
7.0.0-preview.3.22175.4 48 12/15/2025
7.0.0-preview.2.22152.2 11 10/02/2026
7.0.0-preview.1.22076.8 4 10/05/2026
6.0.2-mauipre.1.22102.15 57 12/15/2025
6.0.2-mauipre.1.22054.8 45 12/15/2025
6.0.1 63 12/15/2025
6.0.0 86 12/11/2025
6.0.0-rc.2.21480.5 49 12/11/2025
6.0.0-rc.1.21451.13 47 01/05/2026
6.0.0-preview.7.21377.19 43 12/15/2025
6.0.0-preview.6.21352.12 48 12/21/2025
6.0.0-preview.5.21301.5 10 09/29/2026
6.0.0-preview.4.21253.7 46 12/11/2025
6.0.0-preview.3.21201.4 37 12/14/2025
6.0.0-preview.2.21154.6 52 12/11/2025
6.0.0-preview.1.21102.12 43 12/21/2025
5.0.0 59 12/12/2025
5.0.0-rc.2.20475.5 47 12/11/2025
5.0.0-rc.1.20451.14 51 12/16/2025
5.0.0-preview.8.20407.11 9 10/04/2026
5.0.0-preview.7.20364.11 6 09/30/2026
5.0.0-preview.6.20305.6 45 12/15/2025
5.0.0-preview.5.20278.1 41 12/14/2025
5.0.0-preview.4.20251.6 7 09/30/2026
5.0.0-preview.3.20215.2 46 12/14/2025
5.0.0-preview.2.20160.3 51 12/14/2025
5.0.0-preview.1.20120.4 48 12/13/2025
3.1.32 69 12/14/2025
3.1.31 50 01/09/2026
3.1.30 46 12/20/2025
3.1.29 45 12/16/2025
3.1.28 36 12/15/2025
3.1.27 37 12/15/2025
3.1.26 56 12/12/2025
3.1.25 53 12/14/2025
3.1.24 10 09/27/2026
3.1.23 45 12/20/2025
3.1.22 35 12/14/2025
3.1.21 47 12/20/2025
3.1.20 44 12/20/2025
3.1.19 53 12/14/2025
3.1.18 65 12/20/2025
3.1.17 40 12/11/2025
3.1.16 57 12/15/2025
3.1.15 56 12/20/2025
3.1.14 48 12/14/2025
3.1.13 57 12/20/2025
3.1.12 49 12/20/2025
3.1.11 44 12/15/2025
3.1.10 45 12/20/2025
3.1.9 55 12/14/2025
3.1.8 55 12/20/2025
3.1.7 33 12/15/2025
3.1.6 48 01/03/2026
3.1.5 40 12/20/2025
3.1.4 30 12/14/2025
3.1.3 44 12/20/2025
3.1.2 55 12/15/2025
3.1.1 52 12/15/2025
3.1.0 55 01/06/2026
3.1.0-preview3.19553.2 10 09/29/2026
3.1.0-preview2.19525.4 12 10/06/2026
3.1.0-preview1.19506.1 8 10/04/2026
3.0.3 65 12/18/2025
3.0.2 52 12/17/2025
3.0.1 56 12/14/2025
3.0.0 52 12/14/2025
3.0.0-rc1.19456.10 54 12/10/2025
3.0.0-preview9.19423.4 42 12/11/2025
3.0.0-preview8.19405.4 56 12/15/2025
3.0.0-preview7.19362.4 51 12/18/2025
3.0.0-preview6.19304.6 9 10/01/2026
3.0.0-preview5.19227.9 11 09/30/2026
3.0.0-preview4.19216.2 10 10/04/2026
3.0.0-preview3.19153.1 41 12/14/2025
3.0.0-preview.19074.2 45 12/11/2025
3.0.0-preview.18572.1 10 10/03/2026
2.2.4 46 12/15/2025
2.2.0 58 12/14/2025
2.2.0-preview3-35497 52 12/30/2025
2.2.0-preview2-35157 14 09/28/2026
2.2.0-preview1-35029 48 12/21/2025
2.1.10 34 12/20/2025
2.1.1 12 09/28/2026
2.1.0 56 12/28/2025
2.1.0-rc1-final 55 12/20/2025
2.1.0-preview2-final 60 12/11/2025
2.1.0-preview1-final 39 12/16/2025
2.0.2 53 12/18/2025
2.0.1 47 12/20/2025
2.0.0 57 12/14/2025
2.0.0-preview2-final 56 12/16/2025
2.0.0-preview1-final 11 10/02/2026
1.1.2 58 01/01/2026
1.1.1 48 12/16/2025
1.1.0 36 12/12/2025
1.1.0-preview1-final 34 12/19/2025
1.0.2 44 01/12/2026
1.0.1 33 01/03/2026
1.0.0 46 12/17/2025
1.0.0-rc2-final 44 12/14/2025
1.0.0-rc1-final 11 09/29/2026