命令行參數
平常在日常的開發過程中，會經常用到命令行工具。如cmd下的各種命令。
以下為sc命令執行后的截圖，可以看到，由於沒有輸入任何附帶參數，所以程序並未執行任何操作，只是輸出了描述和用法。
系統在創建一個新進程時，會傳一個命令行給它，也就是命令行字符串。
程序需要對命令行字符串進行解析，並執行相應操作。
如使用sc query可以查詢當前系統的服務：
在C#中的控制台程序中，Main函數中傳入的args字符串數組，就是系統傳入進程的命令行參數。
在構建具有復雜命令行參數的控制台程序時 ，手動解析參數就變得非常麻煩。這里推薦一個開源的庫，可以更加方便的解析命令行參數。
System.CommandLine介紹
System.CommandLine是一個基於.Net Standard 2.0（支持.Net FrameWork 4.6.1.2+和.Net Core 2.0+）的命令行參數解析庫，項目地址 https://github.com/dotnet/command-line-api，目前，該項目還是屬於beta狀態，期待以后的正式版本。
由於不是正式版本，在Nuget中引用時，需要鈎上Include prerelease，才能找到這個包。
System.CommandLine的一些基本概念
Token(標記)
命令行的每個單詞都是一個標記，如下面的"sc"、"query"和"eventlog"都是一個Token
Commands(命令)
Commands就是應用程序根據Token執行相應的操作(在System.CommandLine庫中，對應 Command類)
Root Command(根命令)
根命令是代表可執行程序本身的Commands，如 sc(在System.CommandLine庫中，對應RootCommand類)
SubCommands(子命令)
一些命令行程序會有SubCommands，如上面的sc query中的query就是子命令(在System.CommandLine，對應Command類)
Options(可選項)
Options就是傳遞給Commands的命名參數，如 app -myoption123中的 -myoption 123就是一個Options
Argument(參數)
參數就是傳遞給選項或命令的值。
說明：
常規的調用如下：
xx.exe [options] <argument> [command]
Delimiters（分隔符）
分隔符就是把Options的命令和值分開的符號
如下三種寫法都是一樣的，可以使用空格、=或 ：符號
app -myoption 123
app -myoption=123
app -myoption:123
Aliases(別名)
可以為命令或選項設置較短的別名，如
-v, --verbose
--o, --option
System.CommandLine使用
在下面的示例中，我們會構建一個簡單的控制台爬蟲工具。
1、使用Visual Studio 2019創建一個.Net Core控制台程序crawler-line
2、導入System.CommandLine包
3、創建一個RootCommand
1 var rootCommand = new RootCommand 2 { 3 new Argument<string>( 4 "url","web site url"), 5 new Option<bool>(new string[]{ "--gethtml" ,"-html"},"Get html source"), 6 new Option<bool>(new string[]{ "--getimage" ,"-image"},"Get images"), 7 new Option<bool>(new string[]{ "--regex-option" ,"-regex"},"Use regex"), 8 new Option<bool>(new string[]{ "--htmlagilitypack-option", "-agpack"},"Use HtmlAgilityPack"), 9 new Option<bool>(new string[]{ "--anglesharp-option", "-agsharp"},"Use AngleSharp"), 10 new Option<string>(new string[]{ "--download-path" ,"-path"},"Designate download path"),13 };
說明：
可通過Option類的構造函數重載，為Option指定默認值。
1 public Option(string alias, Func<T> getDefaultValue, string? description = null);
如上面的-path Option，指定默認值為D:\download，如下：
1 new Option<string>(new string[]{ "--download-path" ,"-path"},getDefaultValue:()=>"D:\\download","Designate download path"),
也可以先實例化RootCommand對象，再通過Add的方式添加Argument和Option，如下：
1 var rootCommand = new RootCommand(); 2 //添加 Argument 3 rootCommand.AddArgument(new Argument<string>("url","web site url")); 4 //添加 Option 5 rootCommand.AddOption(new Option<string>(new string[] {"--download-path","-path" },"download path"));
4、添加當前命令行程序的描述信息
1 rootCommand.Description = ".Net Core command-line crawler.";
5、解析Argument和Option
rootCommand.Handler = CommandHandler.Create<string, bool, bool, bool, bool, bool, string>((string url, bool html, bool image, bool regex, bool agpack, bool agsharp, string path) => { });
如果覺得參數太長，可以封裝成類，再進行調用，如下：
1 public class CrawlerOption
2 { 3 public string Url { get; set; } 4 public bool GetHtml { get; set; } 5 public bool GetImage { get; set; } 6 public bool RegexOption { get; set; } 7 public bool HtmlagilitypackOption { get; set; } 8 public bool AnglesharpOption { get; set; } 9 public string DownloadPath { get; set; } 10 }
1 rootCommand.Handler = CommandHandler.Create<CrawlerOption>((crawlerOption) =>
2 {
3
4 })
6、添加Command並為Command添加處理函數
1 //添加 Command 2 var githubCommand = new Command("github", "fork me on github"); 3 //添加 Command的處理函數 4 githubCommand.Handler = CommandHandler.Create(() => { System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo("cmd", $"/c start https://github.com/zhaotianff/Crawler-Line")); });5 //將Command添加 到RootCommand 6 rootCommand.AddCommand(githubCommand);
說明：
1、RootCommand是頂級命令，RootCommand可以添加Command，Command又可以再添加SubCommand。如此可以無限循環，沒有限制 。但建議還是不要添加太多級的Command，調用的時候會不太友好
2、Command和RootCommand原理一樣，如果需要為Command添加Argument、Option和Command，可以參照前面的示例
7、調用解析
1 return rootCommand.InvokeAsync(args).Result;
8、調用示例
#執行github command crawler-line.exe github #執行github subcommand crawler-line.exe github sub #執行argument option crawler-line.exe http://www.baidu.com -path "D:\test"
特別提示：
前面示例中，都是為RootCommand添加的Argument和Option，如果又指定 -path(Option)，又執行github（Command）肯定會失敗。因為github這個命令是RootCommand的子命令，而-path選項是為RootCommand添加的
示例代碼