asp.net core支持外部文件和命令行參數方式來配置系統運行所需要的配置信息,我們從下麵兩個常用場景來具體說下具體使用方法。 一、監聽地址及埠配置 1,命令行方式 asp.net core系統通過命令行方式啟動,使用的命令如下: dotnet run 上面的命令直接在源代碼目錄下執行,便可以 ...
asp.net core支持外部文件和命令行參數方式來配置系統運行所需要的配置信息,我們從下麵兩個常用場景來具體說下具體使用方法。
一、監聽地址及埠配置
1,命令行方式
asp.net core系統通過命令行方式啟動,使用的命令如下:
dotnet run
上面的命令直接在源代碼目錄下執行,便可以編譯程式並運行。那對於已經發佈好的程式,就不能使用上面的指令了,應該使用下麵的指令:
dotnet 程式集文件名(程式集文件名就是程式發佈後生成的dll文件)
上面兩個指令都能夠啟動應用程式。程式啟動後,預設監聽地址及埠是http://localhost:5000。但是程式發佈後,肯定不會使用預設的地址及埠,那如果要想讓啟動時監聽其他的地址或功能變數名稱怎麼辦?答案是使用--urls參數,具體指令格式如下:
dotnet run --urls="http://功能變數名稱:埠號"
如果想設置多個功能變數名稱,可以使用分號分隔。
程式預設情況下是不支持參數傳遞的,我們需要對程式進行一些配置。首先需要引入Microsoft.Extensions.Configuration.CommandLine庫文件,然後在main方法中添加commandline支持,具體代碼如下:
public class Program { public static void Main(string[] args) { var config = new ConfigurationBuilder() .AddCommandLine(args)//增加commandline支持 .Build(); var host = new WebHostBuilder() .UseConfiguration(config) .UseKestrel() .UseContentRoot(Directory.GetCurrentDirectory()) .UseIISIntegration() .UseStartup<Startup>() .UseApplicationInsights() .Build(); host.Run(); } }
經過配置後就可以使用上面的指令傳遞參數了
2,配置文件
asp.net core配置信息也可以放置在一個配置文件中,系統啟動時進行載入配置文件內容,來影響程式啟動所需要的環境參數。我們來看一下具體操作過程。
首先我們需要引入一個庫文件"Microsoft.Extensions.Configuration.Json",然後在main方法中引入配置文件路徑信息,具體代碼如下:
public class Program { public static void Main(string[] args) { var config = new ConfigurationBuilder() .SetBasePath(Directory.GetCurrentDirectory()) .AddJsonFile("hosting.json") .Build(); var host = new WebHostBuilder() .UseConfiguration(config) .UseKestrel() .UseContentRoot(Directory.GetCurrentDirectory()) .UseIISIntegration() .UseStartup<Startup>() .UseApplicationInsights() .Build(); host.Run(); } }
通過上面方式,我們就增加了一個外部的hosting.json配置文件,在裡面我們可以增加監聽地址信息,內容如下:
{ "server.urls": "http://*:5001" }
二、運行環境配置
在進行項目開發時,常常要求開發環境,測試環境及正式環境的分離,並且不同環境運行的參數都是不一樣的,比如監聽地址,資料庫連接信息等。當然我們把配置信息保存到一個文件中,每次發佈的時候,可以先修改配置文件的內容,然後再進行程式發佈,這樣操作起來無疑是很麻煩,每次發佈都得先確定對應的環境,然後修改配置信息,如果需要同時發佈多個環境版本,那就得進行多次操作。
asp.net core 其實已經考慮到了這樣的場景,我們可以先看下下麵的代碼:
public Startup(IHostingEnvironment env) { var builder = new ConfigurationBuilder() .SetBasePath(env.ContentRootPath) .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true) .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true) .AddEnvironmentVariables(); Configuration = builder.Build(); }
上面的代碼是出現在startup.cs文件中,裡面首先使用AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)載入appsettings配置文件,這個文件里可以放置所有環境共用的信息,後面有一句AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true),env.EnvironmentName其實就是系統環境,根據啟動時設置的EnvironmentName不同,可以載入對應的配置文件內容。
現在的問題是如何去指定這個EnvironmentName?
1,通過命令行指定environment
在執行dotnet run之前,可以先執行以下下麵的指令:
set ASPNETCORE_ENVIRONMENT= 環境名稱,註意這裡沒有引號,直接把環境名稱寫成具體的值即可,比如 set ASPNETCORE_ENVIRONMNET=development
然後再執行dotnet run指令,這樣當前運行就會按照set指令中設置的環境進行運行
2,直接給dotnet run指令傳遞具體參數
先看直接的執行效果:dotnet run --ASPNETCORE_ENVIRONMENT=development
具體做法:引入Microsoft.Extensions.Configuration.CommandLine,Microsoft.Extensions.Configuration.EnvironmentVariables庫文件,然後在main方法中增加環境參數的支持,具體代碼如下:
public class Program { public static void Main(string[] args) { var config = new ConfigurationBuilder() .AddEnvironmentVariables() .AddCommandLine(args) .SetBasePath(Directory.GetCurrentDirectory()) .AddJsonFile("hosting.json") .Build(); var host = new WebHostBuilder() .UseEnvironment(config["ASPNETCORE_ENVIRONMENT"]) .UseConfiguration(config) .UseKestrel() .UseContentRoot(Directory.GetCurrentDirectory()) .UseIISIntegration() .UseStartup<Startup>() .UseApplicationInsights() .Build(); host.Run(); } }
關鍵是AddEnvironmentVariables(),UseEnvironment(config["ASPNETCORE_ENVIRONMENT"])兩處的處理。這樣我們就可以在dotnet run指令後面增加對應的環境參數。