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

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
Microsoft.Extensions.Logging
Logging infrastructure default implementation for Microsoft.Extensions.Logging.
55
Microsoft.Extensions.Logging
Logging infrastructure default implementation for Microsoft.Extensions.Logging.
54
Microsoft.Extensions.Options.ConfigurationExtensions
Provides additional configuration specific functionality related to Options.
54
Microsoft.Identity.Client.Extensions.Msal
This package contains extensions to Microsoft Authentication Library for .NET (MSAL.NET)
52
Microsoft.Extensions.Logging
Logging infrastructure default implementation for Microsoft.Extensions.Logging.
49
Microsoft.Extensions.OptionsModel
Provides a strongly typed way of specifying and accessing settings using dependency injection.
48
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
48
Microsoft.Extensions.Logging
Logging infrastructure default implementation for Microsoft.Extensions.Logging.
46
Microsoft.Extensions.Options.ConfigurationExtensions
Provides additional configuration specific functionality related to Options.
46
Microsoft.AspNetCore.Server.Kestrel.Core
Core components of ASP.NET Core Kestrel cross-platform web server.
46
Microsoft.Extensions.Options.ConfigurationExtensions
Provides additional configuration specific functionality related to Options.
45
Microsoft.Extensions.Logging
Logging infrastructure default implementation for Microsoft.Extensions.Logging.
45
Microsoft.Extensions.Logging
Logging infrastructure default implementation for Microsoft.Extensions.Logging.
44
Microsoft.Extensions.Options.ConfigurationExtensions
Provides additional configuration specific functionality related to Options.
44
Microsoft.Extensions.Logging
Logging infrastructure default implementation for Microsoft.Extensions.Logging.
43
Microsoft.AspNetCore.Server.Kestrel.Core
Core components of ASP.NET Core Kestrel cross-platform web server.
43

.NET Framework 4.6.2

.NET 6.0

.NET 7.0

.NET 8.0

.NET Standard 2.0

Version Downloads Last updated
9.0.0-rc.2.24473.5 4 10/16/2024
9.0.0-rc.1.24431.7 10 9/12/2024
9.0.0-preview.7.24405.7 11 8/14/2024
9.0.0-preview.6.24327.7 18 7/10/2024
9.0.0-preview.5.24306.7 14 6/14/2024
9.0.0-preview.4.24266.19 12 5/26/2024
9.0.0-preview.3.24172.9 15 4/17/2024
9.0.0-preview.2.24128.5 19 3/27/2024
9.0.0-preview.1.24080.9 28 2/21/2024
8.0.2 16 7/10/2024
8.0.1 18 1/11/2024
8.0.0 27 11/16/2023
8.0.0-rc.2.23479.6 34 10/16/2023
8.0.0-rc.1.23419.4 33 9/17/2023
8.0.0-preview.7.23375.6 35 8/9/2023
8.0.0-preview.6.23329.7 28 8/3/2023
8.0.0-preview.5.23280.8 34 7/10/2023
8.0.0-preview.4.23259.5 32 5/20/2023
8.0.0-preview.3.23174.8 35 5/4/2023
8.0.0-preview.2.23128.3 33 5/15/2023
8.0.0-preview.1.23110.8 31 2/24/2023
7.0.4 30 4/7/2023
7.0.3 30 7/16/2023
7.0.2 26 3/19/2023
7.0.1 28 4/8/2023
7.0.0 29 12/6/2022
7.0.0-rc.2.22472.3 43 11/5/2022
7.0.0-rc.1.22426.10 35 9/17/2022
7.0.0-preview.7.22375.6 37 9/18/2022
7.0.0-preview.6.22324.4 38 9/18/2022
7.0.0-preview.5.22301.12 32 6/30/2022
7.0.0-preview.4.22229.4 28 6/30/2022
7.0.0-preview.3.22175.4 32 6/30/2022
7.0.0-preview.2.22152.2 26 6/30/2022
7.0.0-preview.1.22076.8 32 6/30/2022
6.0.2-mauipre.1.22102.15 33 6/30/2022
6.0.2-mauipre.1.22054.8 37 6/30/2022
6.0.0 43 6/30/2022
6.0.0-rc.2.21480.5 39 6/30/2022
6.0.0-rc.1.21451.13 45 6/30/2022
6.0.0-preview.7.21377.19 35 6/30/2022
6.0.0-preview.6.21352.12 34 6/30/2022
6.0.0-preview.5.21301.5 43 6/30/2022
6.0.0-preview.4.21253.7 41 6/30/2022
6.0.0-preview.3.21201.4 40 6/30/2022
6.0.0-preview.2.21154.6 35 6/30/2022
6.0.0-preview.1.21102.12 32 6/30/2022
5.0.0 49 6/30/2022
5.0.0-rc.2.20475.5 39 6/30/2022
5.0.0-rc.1.20451.14 32 6/30/2022
5.0.0-preview.8.20407.11 42 6/30/2022
5.0.0-preview.7.20364.11 35 6/30/2022
5.0.0-preview.6.20305.6 31 6/30/2022
5.0.0-preview.5.20278.1 39 6/30/2022
5.0.0-preview.4.20251.6 45 6/30/2022
5.0.0-preview.3.20215.2 33 6/30/2022
5.0.0-preview.2.20160.3 31 6/30/2022
5.0.0-preview.1.20120.4 30 6/30/2022
3.1.32 27 5/11/2023
3.1.31 27 12/7/2022
3.1.30 32 12/7/2022
3.1.29 48 9/18/2022
3.1.28 40 9/18/2022
3.1.27 31 9/18/2022
3.1.26 32 6/30/2022
3.1.25 42 6/30/2022
3.1.24 27 6/30/2022
3.1.23 30 6/30/2022
3.1.22 30 6/30/2022
3.1.21 41 6/30/2022
3.1.20 31 6/30/2022
3.1.19 46 6/30/2022
3.1.18 30 6/30/2022
3.1.17 29 6/30/2022
3.1.16 31 6/30/2022
3.1.15 29 6/30/2022
3.1.14 33 6/30/2022
3.1.13 28 6/30/2022
3.1.12 31 6/30/2022
3.1.11 30 6/30/2022
3.1.10 36 6/30/2022
3.1.9 44 6/30/2022
3.1.8 33 6/30/2022
3.1.7 30 6/30/2022
3.1.6 34 6/30/2022
3.1.5 31 6/30/2022
3.1.4 34 6/30/2022
3.1.3 33 6/30/2022
3.1.2 31 6/30/2022
3.1.1 29 6/30/2022
3.1.0 30 6/30/2022
3.1.0-preview3.19553.2 40 6/30/2022
3.1.0-preview2.19525.4 40 6/30/2022
3.1.0-preview1.19506.1 33 6/30/2022
3.0.3 39 6/30/2022
3.0.2 32 6/30/2022
3.0.1 37 6/30/2022
3.0.0 40 6/30/2022
3.0.0-rc1.19456.10 41 6/30/2022
3.0.0-preview9.19423.4 41 6/30/2022
3.0.0-preview8.19405.4 36 6/30/2022
3.0.0-preview7.19362.4 36 6/30/2022
3.0.0-preview6.19304.6 37 6/30/2022
3.0.0-preview5.19227.9 34 6/30/2022
3.0.0-preview4.19216.2 34 6/30/2022
3.0.0-preview3.19153.1 41 6/30/2022
3.0.0-preview.19074.2 42 6/30/2022
3.0.0-preview.18572.1 42 6/30/2022
2.2.4 34 6/30/2022
2.2.0 29 6/30/2022
2.2.0-preview3-35497 36 6/30/2022
2.2.0-preview2-35157 49 6/30/2022
2.2.0-preview1-35029 35 6/30/2022
2.1.10 29 6/30/2022
2.1.1 35 6/30/2022
2.1.0 36 6/30/2022
2.1.0-rc1-final 48 6/30/2022
2.1.0-preview2-final 36 6/30/2022
2.1.0-preview1-final 47 6/30/2022
2.0.2 30 6/30/2022
2.0.1 32 6/30/2022
2.0.0 30 6/30/2022
2.0.0-preview2-final 33 6/30/2022
2.0.0-preview1-final 40 6/30/2022
1.1.2 33 6/30/2022
1.1.1 36 6/30/2022
1.1.0 35 6/30/2022
1.1.0-preview1-final 38 6/30/2022
1.0.2 42 6/30/2022
1.0.1 33 6/30/2022
1.0.0 45 6/30/2022
1.0.0-rc2-final 38 6/30/2022
1.0.0-rc1-final 38 6/30/2022