Microsoft.Configuration.ConfigurationBuilders.UserSecrets 3.0.0
前缀已保留
dotnet add package Microsoft.Configuration.ConfigurationBuilders.UserSecrets --version 3.0.0
NuGet\Install-Package Microsoft.Configuration.ConfigurationBuilders.UserSecrets -Version 3.0.0
此命令旨在在 Visual Studio 的包管理器控制台中使用,因为它使用 NuGet 模块版本的 Install-Package。
<PackageReference Include="Microsoft.Configuration.ConfigurationBuilders.UserSecrets" Version="3.0.0" />
对于支持 PackageReference 的项目,请将此 XML 节点复制到项目文件中以引用该代码包。
paket add Microsoft.Configuration.ConfigurationBuilders.UserSecrets --version 3.0.0
NuGet 团队不提供对此客户端的支持。请联系其 维护者 以获得支持。
#r "nuget: Microsoft.Configuration.ConfigurationBuilders.UserSecrets, 3.0.0"
#r 指令可用于 F# Interactive 和 Polyglot Notebooks。请将此内容复制到交互式工具或脚本源代码中,以引用该代码包。
// Install Microsoft.Configuration.ConfigurationBuilders.UserSecrets as a Cake Addin #addin nuget:?package=Microsoft.Configuration.ConfigurationBuilders.UserSecrets&version=3.0.0 // Install Microsoft.Configuration.ConfigurationBuilders.UserSecrets as a Cake Tool #tool nuget:?package=Microsoft.Configuration.ConfigurationBuilders.UserSecrets&version=3.0.0
NuGet 团队不提供对此客户端的支持。请联系其 维护者 以获得支持。
UserSecrets ConfigBuilder
此代码包提供了一种从包含SECRET列表的Xml
文件(通常存储在源控制之外)获取值的配置构建器。可以直接配置秘密文件,也可以通过userSecretsId
指定,该ID帮助在已知'UserSecrets'目录中定位文件。有关使用此构建器的更全面文档,请参阅 MicrosoftConfigBuilders项目。
以下给出了此构建器的基本用法。[]中的参数是可选的。()组中的参数是互斥的。以@开头的参数允许替换appSettings。所有构建器的第一个参数行是通用的且可选的。其意义和用法在MicrosoftConfigBuilders项目中有记录。为了简洁起见,它们被分为一行。每行下面的特定构建器设置随后紧跟着一个简要说明。当一个构建器使用与整个MicrosoftConfigBuilders项目不同的默认值时,这些不同的默认值也将列出。
<add name="UserSecrets"
[@mode|@enabled="optional"|@charMap|@prefix|@stripPrefix|tokenPattern|@escapeExpandedValues]
(@userSecretsId="12345678-90AB-CDEF-1234-567890" | @userSecretsFile="~\secrets.file")
type="Microsoft.Configuration.ConfigurationBuilders.UserSecretsConfigBuilder, Microsoft.Configuration.ConfigurationBuilders.UserSecrets" />
userSecretsId
- 这是识别xml密钥文件的首选方法。它与.Net Core相似,使用'UserSecretsId'项目属性来存储此标识符。具有此属性的UserSecretsConfigBuilder
将在一个已知的本地位置(Windows环境中的%APPDATA%\Microsoft\UserSecrets\\secrets.xml)查找属于此标识符的密钥文件。 userSecretsFile
- 一个可选属性,指定包含密钥的文件。可以使用'~'字符在起始位置引用应用程序根目录。此属性或'userSecretsId'属性之一是必须的。如果两者都指定,则'userSecretsFile'属性具有优先权。
V3更新
更完整的更新列表可在此处找到:。这些是对此构建器最为相关的更新。
- ⚠️ 打破性的变化 -
Expand
模式已消失。它已被Token
模式取代。 optional
属性已过时 ⇒enabled
属性提供了更多灵活性的替代品。(如果没有最新的enabled
属性,optional
属性仍然会被解析和识别,但构建器应尽可能迁移到使用新的属性名称。安装脚本应尝试自动处理这种情况。)
V2更新
更完整的更新列表可在此处找到:。这些是对此构建器最为相关的更新。
- ConfigBuilder 参数来自 AppSettings - 这是我 conferred 配置构建器中人们最常询问的功能之一。在 V2 中,现在可以从
appSettings
中读取配置构建器的初始化参数。更多关于它的信息可以在中找到。 - [[已弃用]] 这已被
enabled
标签取代。(基本可选标签 - 此项目在 V1 中使用的某些构建器的)optional
标签已移至基类,现在可以在所有键/值配置构建器中使用。
产品 | 版本 兼容和附加计算目标框架版本。 |
---|---|
.NET Framework | net471 is compatible. net472 was computed. net48 was computed. net481 was computed. |
NuGet 包
此包没有被任何 NuGet 包使用。
GitHub 仓库
此包没有被任何流行的 GitHub 仓库使用。
版本 | 下载 | 最后更新 |
---|---|---|
3.0.0 | 323,947 | 4/12/2023 |
3.0.0-preview2 | 900 | 1/18/2023 |
3.0.0-preview1 | 13,493 | 4/1/2022 |
2.0.0 | 2,425,688 | 2/22/2020 |
2.0.0-rc | 2,250 | 1/10/2020 |
2.0.0-beta | 14,735 | 2/26/2019 |
1.0.2 | 256,453 | 7/9/2018 |
1.0.1 | 16,075 | 5/25/2018 |
1.0.0-preview3 | 1,586 | 5/4/2018 |
1.0.0-preview2 | 1,755 | 3/10/2018 |
1.0.0-preview | 1,644 | 11/17/2017 |