Microsoft.Extensions.Configuration.CommandLine

Extension methods for registering with .

Adds a that reads configuration values from the command line.

The to add to. The command line args. The . The values passed on the command line, in the args string array, should be a set of keys prefixed with two dashes ("--") and then values, separate by either the equals sign ("=") or a space (" "). A forward slash ("/") can be used as an alternative prefix, with either equals or space, and when using an equals sign the prefix can be left out altogether. There are five basic alternative formats for arguments: key1=value1 --key2=value2 /key3=value3 --key4 value4 /key5 value5. A simple console application that has five values.


                 // dotnet run key1=value1 --key2=value2 /key3=value3 --key4 value4 /key5 value5
            
                 using Microsoft.Extensions.Configuration;
                 using System;
            
                 namespace CommandLineSample
                 {
                    public class Program
                    {
                        public static void Main(string[] args)
                        {
                            var builder = new ConfigurationBuilder();
                            builder.AddCommandLine(args);
            
                            var config = builder.Build();
            
                            Console.WriteLine($"Key1: '{config["Key1"]}'");
                            Console.WriteLine($"Key2: '{config["Key2"]}'");
                            Console.WriteLine($"Key3: '{config["Key3"]}'");
                            Console.WriteLine($"Key4: '{config["Key4"]}'");
                            Console.WriteLine($"Key5: '{config["Key5"]}'");
                        }
                    }
                 }

Adds a that reads configuration values from the command line using the specified switch mappings.

The to add to. The command line args. The switch mappings. A dictionary of short (with prefix "-") and alias keys (with prefix "--"), mapped to the configuration key (no prefix). The . The switchMappings allows additional formats for alternative short and alias keys to be used from the command line. Also see the basic version of AddCommandLine for the standard formats supported. Short keys start with a single dash ("-") and are mapped to the main key name (without prefix), and can be used with either equals or space. The single dash mappings are intended to be used for shorter alternative switches. Note that a single dash switch cannot be accessed directly, but must have a switch mapping defined and accessed using the full key. Passing an undefined single dash argument will cause as FormatException. There are two formats for short arguments: -k1=value1 -k2 value2. Alias key definitions start with two dashes ("--") and are mapped to the main key name (without prefix), and can be used in place of the normal key. They also work when a forward slash prefix is used in the command line (but not with the no prefix equals format). There are only four formats for aliased arguments: --alt3=value3 /alt4=value4 --alt5 value5 /alt6 value6. A simple console application that has two short and four alias switch mappings defined.


                 // dotnet run -k1=value1 -k2 value2 --alt3=value2 /alt4=value3 --alt5 value5 /alt6 value6
            
                 using Microsoft.Extensions.Configuration;
                 using System;
                 using System.Collections.Generic;
            
                 namespace CommandLineSample
                 {
                    public class Program
                    {
                        public static void Main(string[] args)
                        {
                            var switchMappings = new Dictionary<string, string>()
                            {
                                { "-k1", "key1" },
                                { "-k2", "key2" },
                                { "--alt3", "key3" },
                                { "--alt4", "key4" },
                                { "--alt5", "key5" },
                                { "--alt6", "key6" },
                            };
                            var builder = new ConfigurationBuilder();
                            builder.AddCommandLine(args, switchMappings);
            
                            var config = builder.Build();
            
                            Console.WriteLine($"Key1: '{config["Key1"]}'");
                            Console.WriteLine($"Key2: '{config["Key2"]}'");
                            Console.WriteLine($"Key3: '{config["Key3"]}'");
                            Console.WriteLine($"Key4: '{config["Key4"]}'");
                            Console.WriteLine($"Key5: '{config["Key5"]}'");
                            Console.WriteLine($"Key6: '{config["Key6"]}'");
                        }
                    }
                 }

Adds an that reads configuration values from the command line.

The to add to. Configures the source. The .

Provides configuration key-value pairs that are obtained from the command line.

Initializes a new instance.

The command line args. The switch mappings.

Gets the command-line arguments.

Loads the configuration data from the command-line arguments.

Represents command-line arguments as an .

Gets or sets the switch mappings.

Gets or sets the command line arguments.

Builds the for this source.

The . A .

Keys in switch mappings are case-insensitive. A duplicated key '{0}' was found.

The switch mappings contain an invalid switch '{0}'.

The short switch '{0}' is not defined in the switch mappings.