Microsoft.Extensions.Configuration.Binder 9.0.0-rc.2.24473.5

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.

The types contained in this assembly use Reflection at runtime which is not friendly with linking or AOT. To better support linking and AOT as well as provide more efficient strongly-typed binding methods - this package also provides a source generator. This generator is enabled by default when a project sets PublishAot but can also be enabled using <EnableConfigurationBindingGenerator>true</EnableConfigurationBindingGenerator>.

Key Features

  • Configuring existing type instances from a configuration section (Bind)
  • Constructing new configured type instances from a configuration section (Get & GetValue)
  • Generating source to bind objects from a configuration section without a runtime reflection dependency.

How to Use

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>

You can add the following property to enable the source generator. This requires a .NET 8.0 SDK or later.

<PropertyGroup>
  <EnableConfigurationBindingGenerator>true</EnableConfigurationBindingGenerator>
</PropertyGroup>

Main Types

The main types provided by this library are:

  • Microsoft.Extensions.Configuration.ConfigurationBinder
  • Microsoft.Extensions.Configuration.BinderOptions

Additional Documentation

Feedback & Contributing

Microsoft.Extensions.Configuration.Binder is released as open source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.

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

Packages Downloads
Microsoft.Extensions.Logging
Logging infrastructure default implementation for Microsoft.Extensions.Logging.
191
Microsoft.Extensions.Logging
Logging infrastructure default implementation for Microsoft.Extensions.Logging. This package was built from the source code at https://github.com/aspnet/Extensions/tree/0de62ae930da31048ba7e54c8cd0c6c0bcbd9095
189
Microsoft.Extensions.Logging.Configuration
Configuration support for Microsoft.Extensions.Logging.
240
Microsoft.Extensions.Options.ConfigurationExtensions
Provides additional configuration specific functionality related to Options.
189
Microsoft.Extensions.Options.ConfigurationExtensions
Provides additional configuration specific functionality related to Options.
195
Microsoft.Extensions.Options.ConfigurationExtensions
Provides additional configuration specific functionality related to Options.
197
Microsoft.Extensions.Options.ConfigurationExtensions
Provides additional configuration specific functionality related to Options.
198
Microsoft.Extensions.Options.ConfigurationExtensions
Provides additional configuration specific functionality related to Options.
246
Microsoft.Extensions.Options.ConfigurationExtensions
Provides additional configuration specific functionality related to Options.
294
Microsoft.Extensions.Options.ConfigurationExtensions
Provides additional configuration specific functionality related to Options. When using NuGet 3.x this package requires at least version 3.4.
195
Sentry.AspNetCore
Official ASP.NET Core integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
239
Sentry.AspNetCore
Official ASP.NET Core integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
245
Sentry.AspNetCore
Official ASP.NET Core integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
250
Sentry.AspNetCore
Official ASP.NET Core integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
261
Sentry.AspNetCore
Official ASP.NET Core integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
264
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
204
Serilog.Settings.Configuration
Microsoft.Extensions.Configuration (appsettings.json) support for Serilog.
195
Serilog.Settings.Configuration
Microsoft.Extensions.Configuration (appsettings.json) support for Serilog.
205
Serilog.Settings.Configuration
Microsoft.Extensions.Configuration (appsettings.json) support for Serilog.
207
Serilog.Settings.Configuration
Microsoft.Extensions.Configuration (appsettings.json) support for Serilog.
264

https://go.microsoft.com/fwlink/?LinkID=799421

.NET Framework 4.6.2

.NET 8.0

.NET 9.0

.NET Standard 2.0

Version Downloads Last updated
11.0.0 0 11/10/2026
11.0.0-rc.3.26522.148 0 10/25/2026
11.0.0-rc.2.26504.105 0 10/13/2026
11.0.0-rc.1.26425.128 28 09/08/2026
11.0.0-preview.7.26381.103 23 08/11/2026
11.0.0-preview.6.26359.118 35 07/15/2026
11.0.0-preview.5.26302.115 37 06/09/2026
11.0.0-preview.4.26230.115 44 05/12/2026
11.0.0-preview.3.26207.106 50 04/14/2026
11.0.0-preview.2.26159.112 57 03/11/2026
11.0.0-preview.1.26104.118 54 02/11/2026
10.0.15 0 11/10/2026
10.0.14 0 10/25/2026
10.0.13 0 10/13/2026
10.0.12 22 09/09/2026
10.0.11 21 08/11/2026
10.0.10 35 07/15/2026
10.0.9 35 06/09/2026
10.0.8 41 05/13/2026
10.0.7 58 04/21/2026
10.0.6 40 04/14/2026
10.0.5 63 03/16/2026
10.0.4 54 03/11/2026
10.0.3 62 02/11/2026
10.0.2 59 01/13/2026
10.0.1 103 12/09/2025
10.0.0 97 11/12/2025
10.0.0-rc.2.25502.107 109 10/15/2025
10.0.0-rc.1.25451.107 110 09/09/2025
10.0.0-preview.7.25380.108 122 08/14/2025
10.0.0-preview.6.25358.103 128 07/15/2025
10.0.0-preview.5.25277.114 158 06/07/2025
10.0.0-preview.4.25258.110 115 05/13/2025
10.0.0-preview.3.25171.5 146 04/11/2025
10.0.0-preview.2.25163.2 104 04/01/2025
10.0.0-preview.1.25080.5 131 04/01/2025
9.0.23 0 11/10/2026
9.0.22 0 10/25/2026
9.0.21 0 10/13/2026
9.0.20 19 09/09/2026
9.0.19 26 08/11/2026
9.0.18 32 07/15/2026
9.0.17 37 06/09/2026
9.0.16 26 05/13/2026
9.0.15 55 04/14/2026
9.0.14 51 03/11/2026
9.0.13 62 02/11/2026
9.0.12 61 01/13/2026
9.0.11 104 11/12/2025
9.0.10 97 10/15/2025
9.0.9 126 09/09/2025
9.0.8 115 08/05/2025
9.0.7 142 07/09/2025
9.0.6 111 06/11/2025
9.0.5 140 05/14/2025
9.0.4 145 04/09/2025
9.0.3 137 03/29/2025
9.0.2 136 03/19/2025
9.0.1 124 03/29/2025
9.0.0 216 11/14/2024
9.0.0-rc.2.24473.5 142 10/22/2024
9.0.0-rc.1.24431.7 126 10/25/2024
9.0.0-preview.7.24405.7 135 08/20/2024
9.0.0-preview.6.24327.7 173 07/23/2024
9.0.0-preview.5.24306.7 151 07/23/2024
9.0.0-preview.4.24266.19 156 07/23/2024
9.0.0-preview.3.24172.9 147 07/23/2024
9.0.0-preview.2.24128.5 159 07/23/2024
9.0.0-preview.1.24080.9 154 07/22/2024
8.0.2 158 07/23/2024
8.0.1 166 07/23/2024
8.0.0 246 02/04/2024
8.0.0-rc.2.23479.6 173 07/23/2024
8.0.0-rc.1.23419.4 154 07/23/2024
8.0.0-preview.7.23375.6 164 07/23/2024
8.0.0-preview.6.23329.7 144 07/23/2024
8.0.0-preview.5.23280.8 160 07/23/2024
8.0.0-preview.4.23259.5 163 07/23/2024
8.0.0-preview.3.23174.8 158 07/23/2024
8.0.0-preview.2.23128.3 139 07/23/2024
8.0.0-preview.1.23110.8 172 07/23/2024
7.0.4 150 07/21/2024
7.0.3 151 07/23/2024
7.0.2 158 07/23/2024
7.0.1 152 07/23/2024
7.0.0 155 02/05/2024
7.0.0-rc.2.22472.3 143 07/19/2024
7.0.0-rc.1.22426.10 149 07/23/2024
7.0.0-preview.7.22375.6 133 08/12/2024
7.0.0-preview.6.22324.4 155 07/23/2024
7.0.0-preview.5.22301.12 141 07/23/2024
7.0.0-preview.4.22229.4 163 07/23/2024
7.0.0-preview.3.22175.4 132 07/23/2024
7.0.0-preview.2.22152.2 151 07/23/2024
7.0.0-preview.1.22076.8 155 07/23/2024
6.0.2-mauipre.1.22054.8 132 11/25/2024
6.0.1 125 11/14/2024
6.0.0 263 02/04/2024
6.0.0-rc.2.21480.5 170 07/23/2024
6.0.0-rc.1.21451.13 149 07/23/2024
6.0.0-preview.7.21377.19 160 07/23/2024
6.0.0-preview.6.21352.12 151 07/23/2024
6.0.0-preview.5.21301.5 140 07/23/2024
6.0.0-preview.4.21253.7 139 07/23/2024
6.0.0-preview.3.21201.4 156 07/23/2024
6.0.0-preview.2.21154.6 144 07/23/2024
6.0.0-preview.1.21102.12 143 07/23/2024
5.0.0 165 07/23/2024
5.0.0-rc.2.20475.5 152 07/23/2024
5.0.0-rc.1.20451.14 150 07/23/2024
5.0.0-preview.8.20407.11 147 07/23/2024
5.0.0-preview.7.20364.11 142 07/23/2024
5.0.0-preview.6.20305.6 150 07/23/2024
5.0.0-preview.5.20278.1 156 07/23/2024
5.0.0-preview.4.20251.6 139 07/23/2024
5.0.0-preview.3.20215.2 158 07/23/2024
5.0.0-preview.2.20160.3 145 07/23/2024
5.0.0-preview.1.20120.4 166 07/23/2024
3.1.32 154 07/23/2024
3.1.31 156 07/23/2024
3.1.30 153 07/20/2024
3.1.29 149 07/23/2024
3.1.28 158 07/23/2024
3.1.27 179 07/23/2024
3.1.26 150 07/23/2024
3.1.25 165 07/19/2024
3.1.24 157 07/23/2024
3.1.23 173 07/23/2024
3.1.22 140 07/23/2024
3.1.21 156 07/23/2024
3.1.20 157 07/23/2024
3.1.19 167 07/23/2024
3.1.18 122 07/23/2024
3.1.17 155 07/22/2024
3.1.16 162 07/23/2024
3.1.15 161 07/23/2024
3.1.14 159 07/23/2024
3.1.13 133 07/23/2024
3.1.12 176 07/17/2024
3.1.11 166 07/23/2024
3.1.10 164 07/23/2024
3.1.9 159 07/23/2024
3.1.8 146 07/22/2024
3.1.7 140 07/23/2024
3.1.6 187 07/23/2024
3.1.5 153 07/23/2024
3.1.4 165 07/23/2024
3.1.3 150 07/23/2024
3.1.2 149 07/23/2024
3.1.1 148 07/18/2024
3.1.0 166 07/23/2024
3.1.0-preview3.19553.2 141 07/23/2024
3.1.0-preview2.19525.4 159 07/23/2024
3.1.0-preview1.19506.1 156 07/23/2024
3.0.3 158 07/23/2024
3.0.2 145 07/23/2024
3.0.1 158 07/23/2024
3.0.0 170 07/23/2024
3.0.0-rc1.19456.10 151 07/23/2024
3.0.0-preview9.19423.4 167 07/20/2024
3.0.0-preview8.19405.4 135 07/23/2024
3.0.0-preview7.19362.4 154 07/23/2024
3.0.0-preview6.19304.6 172 07/23/2024
3.0.0-preview5.19227.9 164 07/23/2024
3.0.0-preview4.19216.2 148 07/23/2024
3.0.0-preview3.19153.1 155 07/19/2024
3.0.0-preview.19074.2 157 07/23/2024
3.0.0-preview.18572.1 146 07/23/2024
2.2.4 149 07/23/2024
2.2.0 148 07/23/2024
2.2.0-preview3-35497 135 07/23/2024
2.2.0-preview2-35157 146 07/23/2024
2.2.0-preview1-35029 149 07/23/2024
2.1.10 142 07/23/2024
2.1.1 160 07/23/2024
2.1.0 141 07/23/2024
2.1.0-rc1-final 153 07/23/2024
2.1.0-preview2-final 149 07/20/2024
2.1.0-preview1-final 147 07/23/2024
2.0.2 158 07/23/2024
2.0.1 152 07/23/2024
2.0.0 224 02/04/2024
2.0.0-preview2-final 159 07/23/2024
2.0.0-preview1-final 144 07/23/2024
1.1.2 161 07/23/2024
1.1.1 168 07/22/2024
1.1.0 150 07/23/2024
1.1.0-preview1-final 158 07/14/2024
1.0.2 150 07/23/2024
1.0.1 141 07/23/2024
1.0.0 163 07/22/2024
1.0.0-rc2-final 156 07/22/2024
1.0.0-rc1-final 167 07/23/2024