ConfigurationBuilder Класс
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет базовый класс, расширяемый пользовательскими реализациями построителя конфигурации.
public ref class ConfigurationBuilder abstract : System::Configuration::Provider::ProviderBase
public abstract class ConfigurationBuilder : System.Configuration.Provider.ProviderBase
type ConfigurationBuilder = class
inherit ProviderBase
Public MustInherit Class ConfigurationBuilder
Inherits ProviderBase
- Наследование
В следующем примере показано, как реализовать простой ConfigurationBuilder для чтения переменных среды:
using System;
using System.Configuration;
using System.Xml;
namespace Samples.AspNet.Config
{
public class SampleConfigurationBuilder : ConfigurationBuilder
{
public override XmlNode ProcessRawXml(XmlNode rawXml)
{
string rawXmlString = rawXml.OuterXml;
if (String.IsNullOrEmpty(rawXmlString)) {
return rawXml;
}
rawXmlString = Environment.ExpandEnvironmentVariables(rawXmlString);
XmlDocument doc = new XmlDocument();
doc.PreserveWhitespace = true;
doc.LoadXml(rawXmlString);
return doc.DocumentElement;
}
public override ConfigurationSection ProcessConfigurationSection(ConfigurationSection configSection)
=> configSection;
}
}
Imports System.Configuration
Imports System.Xml
Public Class SampleConfigurationBuilder : Inherits ConfigurationBuilder
Public Overrides Function ProcessRawXml(rawXml As XmlNode) As XmlNode
Dim rawXmlString As String = rawXml.OuterXml
If String.IsNullOrEmpty(rawXmlString) Then
Return rawXml
End If
rawXmlString = Environment.ExpandEnvironmentVariables(rawXmlString)
Dim doc As New XmlDocument()
doc.PreserveWhitespace = True
doc.LoadXml(rawXmlString)
Return doc.DocumentElement
End Function
Public Overrides Function ProcessConfigurationSection(configSection As ConfigurationSection) As ConfigurationSection
Return configSection
End Function
End Class
В следующем примере приведен фрагмент файла конфигурации, применимый к предыдущему примеру. Это применяет переменные среды к конфигурации appSettings и делает эти значения доступными в .ConfigurationManager.AppSettings
<!-- To declare and use Configuration Builders in your configuration chain, update your app.config or web.config file as follows: -->
<configSections>
<section name="configBuilders" type="System.Configuration.ConfigurationBuildersSection, System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" restartOnExternalChanges="false" requirePermission="false"/>
</configSections>
<configBuilders>
<builders>
<add name="SampleConfigurationBuilder" type="CustomConfigBuilders.MyConfigBuilder, CustomConfigBuilders" />
</builders>
</configBuilders>
<!-- To apply Configuration Builders to a configuration section, use the 'configBuilders' tag as follows: -->
<appSettings configBuilders="SampleConfigurationBuilder">
<add key="COMPUTERNAME" value="Will Be Replaced by EnvironmentVariable" />
</appSettings>
Наследуйте от этого класса для чтения конфигурации из внешнего источника, который вы хотите использовать в приложении платформа .NET Framework с помощью стандартного ConfigurationManager API. ConfigurationBuilders доступны на NuGet.org для чтения из переменных среды, хранилища ключей Azure и ряда других источников.
В NuGet.org доступно несколько реализаций ConfigurationBuilders:
- EnvironmentConfigBuilder — чтение из переменных среды.
- AzureKeyVaultConfigBuilder — чтение из azure Key Vault.
- UserSecretsConfigBuilder — чтение из файла usersecrets на диске, аналогично функции ASP.NET Core.
- SimpleJsonConfigBuilder — чтение из JSON-файла.
Configuration |
Инициализирует новый экземпляр класса ConfigurationBuilder. |
Description |
Возвращает краткое, понятное описание, подходящее для отображения в инструментах администрирования или других пользовательских интерфейсах (UI). (Унаследовано от ProviderBase) |
Name |
Возвращает понятное имя, используемое для ссылки на поставщика во время конфигурирования. (Унаследовано от ProviderBase) |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
Get |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
Get |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
Initialize(String, Name |
Инициализирует построитель конфигураций. (Унаследовано от ProviderBase) |
Memberwise |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
Process |
Принимает объект ConfigurationSection из системы конфигурации и возвращает измененный или новый объект ConfigurationSection для дальнейшего использования. |
Process |
Принимает XmlNode, представляющий необработанный раздел конфигурации из файла конфигурации, и возвращает измененный или новый XmlNode для дальнейшего использования. |
To |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
.NET кері байланысы
.NET — бастапқы коды ашық жоба. Пікір қалдыру үшін сілтемені таңдаңыз: