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                
#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                

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. 
兼容目标框架
包含的目标框架(包含在包中)
了解有关 目标框架.NET Standard 的更多信息。

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