docs: Add samples on how to create sections with the .NET configuration system

samples/DotEnv.Example.ConfigurationApi/.env

@@ -1 +1,3 @@
-APP_BASE_URL=https://github.com/MrDave1999/dotenv.core
+Settings__APP_BASE_URL=https://github.com/MrDave1999/dotenv.core
+Settings__SERVER=example.com
+Settings__DATABASE=Northwind

samples/DotEnv.Example.ConfigurationApi/HomeController.cs

@@ -14,8 +14,21 @@ public HomeController(IConfiguration configuration)
     }
 
     [HttpGet]
-    public string Get()
+    public SettingsDto Get()
     {
-        return _configuration["APP_BASE_URL"];
+        var section = _configuration.GetSection("Settings");
+        return new()
+        {
+            AppBaseUrl = section["APP_BASE_URL"],
+            Server     = section["SERVER"],
+            Database   = section["DATABASE"]
+        };
+    }
+
+    public class SettingsDto
+    {
+        public string AppBaseUrl { get; init; }
+        public string Server { get; init; }
+        public string Database { get; init; }
     }
 }

samples/DotEnv.Example.OptionsPattern/.env

@@ -1 +1,3 @@
-AppBaseUrl=https://github.com/MrDave1999/dotenv.core
+Settings__AppBaseUrl=https://github.com/MrDave1999/dotenv.core
+Settings__Server=example.com
+Settings__Database=Northwind

samples/DotEnv.Example.OptionsPattern/AppSettings.cs

@@ -3,4 +3,6 @@
 public class AppSettings
 {
     public string AppBaseUrl { get; init; }
+    public string Server {  get; init; }
+    public string Database {  get; init; }
 }

samples/DotEnv.Example.OptionsPattern/HomeController.cs

@@ -15,8 +15,8 @@ public HomeController(IOptions<AppSettings> options)
     }
 
     [HttpGet]
-    public string Get()
+    public AppSettings Get()
     {
-        return _appSettings.AppBaseUrl;
+        return _appSettings;
     }
 }

samples/DotEnv.Example.OptionsPattern/Program.cs

@@ -10,7 +10,7 @@
 // Adds environment variables in the configuration collection.
 builder.Configuration.AddEnvironmentVariables();
 // Registers a configuration instance which AppSettings will bind against.
-builder.Services.Configure<AppSettings>(builder.Configuration);
+builder.Services.Configure<AppSettings>(builder.Configuration.GetSection("Settings"));
 
 builder.Services.AddControllers();
 // Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle