Microsoft.Extensions.Options.ConfigurationExtensions 8.0.0-rc.2.23479.6
About
Microsoft.Extensions.Options.ConfigurationExtensions provides additional configuration-specific functionality related to Options.
Key Features
- Extension methods for OptionsBuilder for configuration binding
- Extension methods for IServiceCollection for Options configuration
- ConfigurationChangeTokenSource
for monitoring configuration changes
How to Use
Options Configuration binding
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Options;
class Program
{
// appsettings.json contents:
// {
// "MyOptions": {
// "Setting1": "Value1",
// "Setting2": "Value2"
// }
// }
static void Main(string[] args)
{
IConfiguration configuration = new ConfigurationBuilder()
.SetBasePath(Environment.CurrentDirectory)
.AddJsonFile("appsettings.json")
.Build();
IServiceCollection services = new ServiceCollection();
// Bind the configuration to MyOptions
services.Configure<MyOptions>(configuration.GetSection("MyOptions"));
IServiceProvider serviceProvider = services.BuildServiceProvider();
// Retrieve MyOptions using dependency injection
var myOptions = serviceProvider.GetRequiredService<IOptions<MyOptions>>().Value;
// Access the bound configuration values
Console.WriteLine($"Setting1: {myOptions.Setting1}");
Console.WriteLine($"Setting2: {myOptions.Setting2}");
}
}
public class MyOptions
{
public string Setting1 { get; set; }
public string Setting2 { get; set; }
}
Monitoring options configuration changes
// Assume we have a class that represents some options
public class MyOptions
{
public string Name { get; set; }
public int Age { get; set; }
}
// appsettings.json contents:
// {
// "MyOptions": {
// "Name": "Alice",
// "Age": 25
// }
// }
// Assume we have a configuration object that contains some settings
var config = new ConfigurationBuilder()
.AddJsonFile("appsettings.json")
.Build();
// We can use the ConfigurationChangeTokenSource to create a change token source for the options
var changeTokenSource = new ConfigurationChangeTokenSource<MyOptions>(config.GetSection("MyOptions"));
// We can register the change token source with the options monitor
services.AddOptions<MyOptions>()
.Configure(options =>
{
// Configure the options with the configuration values
config.GetSection("MyOptions").Bind(options);
})
.AddChangeTokenSource(changeTokenSource);
// Now we can inject the options monitor into any class that needs them
public class MyClass
{
private readonly IOptionsMonitor<MyOptions> _optionsMonitor;
public MyClass(IOptionsMonitor<MyOptions> optionsMonitor)
{
_optionsMonitor = optionsMonitor;
}
public void DoSomething()
{
// Can access the current options value like this
var options = _optionsMonitor.CurrentValue;
var name = options.Name;
var age = options.Age;
// Do something with name and age
// Can also register a callback to be notified when the options change
_optionsMonitor.OnChange(newOptions =>
{
// Do something when the options change
});
}
}
Main Types
The main types provided by this library are:
ConfigurationChangeTokenSourceOptionsBuilderConfigurationExtensionsOptionsConfigurationServiceCollectionExtensions
Additional Documentation
Related Packages
- Microsoft.Extensions.Options
- Microsoft.Extensions.Configuration
- Microsoft.Extensions.DependencyInjection
Feedback & Contributing
Microsoft.Extensions.Options.ConfigurationExtensions 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.Options.ConfigurationExtensions.
| Packages | Downloads |
|---|---|
|
Xdot.Paymob.CashIn.DependencyInjection
Xdot.Paymob.CashIn extensions for Dependency Injection. Xdot.Paymob.CashIn is an SDK to help you integrate with the Paymob’s payment gateway.
|
4 |
|
Serilog.Settings.Configuration
Microsoft.Extensions.Configuration (appsettings.json) support for Serilog.
|
4 |
|
Microsoft.Extensions.Logging.Configuration
Configuration support for Microsoft.Extensions.Logging.
When using NuGet 3.x this package requires at least version 3.4.
|
4 |
|
Microsoft.Identity.Web.TokenAcquisition
Implementation for higher level API for confidential client applications (ASP.NET Core and SDK/.NET).
|
4 |
|
Finbuckle.MultiTenant
Main library package for Finbuckle.MultiTenant.
|
3 |
|
Serilog.Sinks.MSSqlServer
A Serilog sink that writes events to Microsoft SQL Server
|
3 |
|
Serilog.Sinks.MSSqlServer
A Serilog sink that writes events to Microsoft SQL Server and Azure SQL
|
3 |
|
Elsa.Workflows.Api
Provides API endpoints for client applications such as the Elsa Designer web component.
|
3 |
|
Serilog.Settings.Configuration
Microsoft.Extensions.Configuration (appsettings.json) support for Serilog.
|
3 |
|
Volo.Abp.Core
Package Description
|
3 |
|
Elsa.Core
Elsa is a set of workflow libraries and tools that enable lean and mean workflowing capabilities in any .NET Core application.
This package contains the core of Elsa.
Tip: reference the `Elsa` package instead of this one.
|
3 |
|
Microsoft.Extensions.Logging.Console
Console logger provider implementation for Microsoft.Extensions.Logging.
When using NuGet 3.x this package requires at least version 3.4.
|
2 |
|
Microsoft.Identity.Web.TokenAcquisition
Implementation for higher level API for confidential client applications (ASP.NET Core and SDK/.NET).
|
2 |
https://go.microsoft.com/fwlink/?LinkID=799421
.NET Framework 4.6.2
- Microsoft.Extensions.Configuration.Abstractions (>= 8.0.0-rc.2.23479.6)
- Microsoft.Extensions.Configuration.Binder (>= 8.0.0-rc.2.23479.6)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0-rc.2.23479.6)
- Microsoft.Extensions.Options (>= 8.0.0-rc.2.23479.6)
- Microsoft.Extensions.Primitives (>= 8.0.0-rc.2.23479.6)
.NET Standard 2.0
- Microsoft.Extensions.Primitives (>= 8.0.0-rc.2.23479.6)
- Microsoft.Extensions.Options (>= 8.0.0-rc.2.23479.6)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0-rc.2.23479.6)
- Microsoft.Extensions.Configuration.Binder (>= 8.0.0-rc.2.23479.6)
- Microsoft.Extensions.Configuration.Abstractions (>= 8.0.0-rc.2.23479.6)
.NET 8.0
- Microsoft.Extensions.Primitives (>= 8.0.0-rc.2.23479.6)
- Microsoft.Extensions.Options (>= 8.0.0-rc.2.23479.6)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0-rc.2.23479.6)
- Microsoft.Extensions.Configuration.Binder (>= 8.0.0-rc.2.23479.6)
- Microsoft.Extensions.Configuration.Abstractions (>= 8.0.0-rc.2.23479.6)
.NET 7.0
- Microsoft.Extensions.Primitives (>= 8.0.0-rc.2.23479.6)
- Microsoft.Extensions.Options (>= 8.0.0-rc.2.23479.6)
- Microsoft.Extensions.Configuration.Binder (>= 8.0.0-rc.2.23479.6)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0-rc.2.23479.6)
- Microsoft.Extensions.Configuration.Abstractions (>= 8.0.0-rc.2.23479.6)
.NET 6.0
- Microsoft.Extensions.Configuration.Abstractions (>= 8.0.0-rc.2.23479.6)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0-rc.2.23479.6)
- Microsoft.Extensions.Options (>= 8.0.0-rc.2.23479.6)
- Microsoft.Extensions.Primitives (>= 8.0.0-rc.2.23479.6)
- Microsoft.Extensions.Configuration.Binder (>= 8.0.0-rc.2.23479.6)