.NET 運(yùn)行時(shí)設(shè)置

.NET 5+（包括 .NET Core 版本）支持使用配置文件和環(huán)境變量在運(yùn)行時(shí)配置 .NET 應(yīng)用程序的行為。如果出現(xiàn)以下情況，則運(yùn)行時(shí)配置是一個(gè)不錯(cuò)的選擇：

• 你不擁有或控制應(yīng)用程序的源代碼，因此無(wú)法以編程方式對(duì)其進(jìn)行配置。

• 應(yīng)用程序的多個(gè)實(shí)例在單個(gè)系統(tǒng)上同時(shí)運(yùn)行，并且你想要將每個(gè)實(shí)例配置為獲得最佳性能。

備注

?

本文檔正在編寫中。如果你注意到此處提供的信息不完整或不準(zhǔn)確，可以創(chuàng)建一個(gè)問題告知我們，或提交拉取請(qǐng)求以解決問題。要了解如何提交 dotnet/docs 存儲(chǔ)庫(kù)的拉取請(qǐng)求，請(qǐng)參閱參與者指南.

”

.NET 提供以下機(jī)制，它們用于配置運(yùn)行時(shí)應(yīng)用程序行為：

• runtimeconfig.json 文件

• MSBuild 屬性

• 環(huán)境變量

提示

?

如果使用環(huán)境變量配置運(yùn)行時(shí)選項(xiàng)，會(huì)將設(shè)置應(yīng)用于所有 .NET 應(yīng)用。如果在 runtimeconfig.json 或項(xiàng)目文件中配置運(yùn)行時(shí)選擇，則僅將設(shè)置應(yīng)用于此應(yīng)用程序。

”

某些配置值還可以通過調(diào)用 AppContext.SetSwitch 方法以編程方式進(jìn)行設(shè)置。

文檔此部分的文章按類別組織，例如調(diào)試和垃圾回收。如果適用，將顯示 runtimeconfig.json 文件、MSBuild 屬性、環(huán)境變量的配置選項(xiàng)；對(duì)于 .NET Framework 項(xiàng)目，還會(huì)顯示 app.config 文件的配置選項(xiàng)以便交叉引用。

runtimeconfig.json

構(gòu)建項(xiàng)目時(shí)，將在輸出目錄中生成 [appname].runtimeconfig.json 文件。如果項(xiàng)目文件所在的文件夾中存在 runtimeconfig.template.json 文件，它包含的任何配置選項(xiàng)都將插入到 [appname].runtimeconfig.json 文件中。如果自行構(gòu)建應(yīng)用，請(qǐng)將所有配置選項(xiàng)放在 runtimeconfig.template.json 文件中。如果只是運(yùn)行應(yīng)用，請(qǐng)將其直接插入 [appname].runtimeconfig.template.json 文件中。

備注

?

后續(xù)生成中將覆蓋 [appname].runtimeconfig.template.json 文件。如果應(yīng)用的 OutputType 不是 Exe，但你想將配置選項(xiàng)從 runtimeconfig.template.json 復(fù)制到 [應(yīng)用名稱].runtimeconfig.json，則必須在項(xiàng)目文件中將 GenerateRuntimeConfigurationFiles 顯式設(shè)置為 true 。對(duì)于需要 runtimeconfig.json 文件的應(yīng)用，此屬性默認(rèn)設(shè)置為 true。在 runtimeconfig.json 文件的 configProperties 部分指定運(yùn)行時(shí)配置選項(xiàng)。如下：

”"configProperties": {"config-property-name1": "config-value1","config-property-name2": "config-value2" }

示例 [appname].runtimeconfig.template.json 文件

如果要將這些選項(xiàng)放在輸出 JSON 文件中，請(qǐng)將它們嵌套在 runtimeOptions 屬性下。

{"runtimeOptions": {"tfm": "netcoreapp3.1","framework": {"name": "Microsoft.NETCore.App","version": "3.1.0"},"configProperties": {"System.GC.Concurrent": false,"System.Threading.ThreadPool.MinThreads": 4,"System.Threading.ThreadPool.MaxThreads": 25}} }

示例 runtimeconfig.template.json 文件

如果要將這些選項(xiàng)放在模板 JSON 文件中，請(qǐng)省略 runtimeOptions 屬性。

{"configProperties": {"System.GC.Concurrent": false,"System.Threading.ThreadPool.MinThreads": "4","System.Threading.ThreadPool.MaxThreads": "25"} }

MSBuild 屬性

可使用 SDK 樣式 .NET Core 項(xiàng)目的 .csproj 或 .vbproj 文件中的 MSBuild 屬性設(shè)置某些運(yùn)行時(shí)配置選項(xiàng)。MSBuild 屬性優(yōu)先于在 runtimeconfig.template.json 文件中設(shè)置的選項(xiàng)。

下面是一個(gè)示例 SDK 樣式項(xiàng)目文件，其中包含用于配置運(yùn)行時(shí)行為的 MSBuild 屬性：

<Project Sdk="Microsoft.NET.Sdk"><PropertyGroup><OutputType>Exe</OutputType><TargetFramework>netcoreapp3.1</TargetFramework></PropertyGroup><PropertyGroup><ConcurrentGarbageCollection>false</ConcurrentGarbageCollection><ThreadPoolMinThreads>4</ThreadPoolMinThreads><ThreadPoolMaxThreads>25</ThreadPoolMaxThreads></PropertyGroup></Project>

用于配置運(yùn)行時(shí)行為的 MSBuild 屬性記錄在每個(gè)區(qū)域各自的文章中，例如垃圾回收。它們還在 SDK 樣式項(xiàng)目的 MSBuild 屬性參考的運(yùn)行時(shí)配置部分中列出。

環(huán)境變量

環(huán)境變量可用于提供一些運(yùn)行時(shí)配置信息。如果使用環(huán)境變量配置運(yùn)行時(shí)選項(xiàng)，會(huì)將設(shè)置應(yīng)用于所有 .NET Core 應(yīng)用。指定為環(huán)境變量的配置旋鈕通常帶有 DOTNET_ 前綴。

備注

?

.NET 6 為用于配置 .NET 運(yùn)行時(shí)行為的環(huán)境變量標(biāo)準(zhǔn)化前綴 DOTNET_ 而不是 COMPlus_。但是，COMPlus_ 前綴仍將繼續(xù)正常工作。如果使用的是早期版本的 .NET 運(yùn)行時(shí)，則環(huán)境變量仍應(yīng)該使用 COMPlus_ 前綴。

”

可以使用 Windows 控制面板、命令行或通過在 Windows 和 Unix 系統(tǒng)上調(diào)用 Environment.SetEnvironmentVariable(String, String) 方法以編程方式定義環(huán)境變量。

下面的示例演示如何在命令行中設(shè)置環(huán)境變量：

# Windows set DOTNET_GCRetainVM=1# Powershell $env:DOTNET_GCRetainVM="1"# Unix export DOTNET_GCRetainVM=1

總結(jié)

以上是生活随笔為你收集整理的.NET 运行时设置的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。