Namh.Configuration.Template
1.0.0
See the version list below for details.
dotnet add package Namh.Configuration.Template --version 1.0.0
NuGet\Install-Package Namh.Configuration.Template -Version 1.0.0
<PackageReference Include="Namh.Configuration.Template" Version="1.0.0" />
<PackageVersion Include="Namh.Configuration.Template" Version="1.0.0" />
<PackageReference Include="Namh.Configuration.Template" />
paket add Namh.Configuration.Template --version 1.0.0
#r "nuget: Namh.Configuration.Template, 1.0.0"
#:package Namh.Configuration.Template@1.0.0
#addin nuget:?package=Namh.Configuration.Template&version=1.0.0
#tool nuget:?package=Namh.Configuration.Template&version=1.0.0
TemplateConfig
TemplateConfig resolves {Path} references in .NET configuration values. Register your usual providers and call BuildTemplateConfig():
var configuration = new ConfigurationBuilder()
.AddJsonFile("appsettings.json")
.BuildTemplateConfig();
The examples below use appsettings.json.
Examples
1. Look up
References can point into parent and sibling fields recursively, example appsetings.json
{
"Primitive": "Pri", // -> Result: "Pri"
"Ref-Primitive1": "--{Primitive}--", // -> Result: "--Pri--"
"Ref-Primitive2": "{Primitive}.{Ref-Primitive1}", // -> Result: "Pri.--Pri--"
"Ref-Primitive-Loop": "--{{Primitive}mitive}--", // -> Result: "--Pri--"
}
var value = configuration["Ref-Primitive-Loop"] // -> Result: "--Pri--"
2. Escape a character
Use a backtick to keep braces literal:
{
"Primitive": "Pri",
"Escaped": "--`{Primitive`}--"
}
Escaped resolves to --{Primitive}--.
3. Error syntax
An unmatched brace throws InvalidOperationException when the value is read:
{
"MissingClose": "--{Primitive--",
"MissingOpen": "--Primitive}--"
}
Build and test
dotnet build src/Template.slnx
dotnet test src/Template.slnx
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Namh.Configuration.Template:
| Package | Downloads |
|---|---|
|
Namh.Configuration.GlobalTemplate
Integrates configuration templates with .NET generic hosts and ASP.NET Core applications, resolving references between values in Microsoft.Extensions.Configuration. |
GitHub repositories
This package is not used by any popular GitHub repositories.