ConfigurationBuilder Třída

Definice

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

Dědičnost

Object

ProviderBase

ConfigurationBuilder

Příklady

Následující příklad ukazuje, jak implementovat jednoduchý ConfigurationBuilder pro čtení proměnných prostředí:

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

Následující příklad je výňatek z konfiguračního souboru, který platí pro předchozí příklad. Tím se na konfiguraci appSettings použijí proměnné prostředí a tyto hodnoty zpřístupníte v části 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>

Poznámky

Odvození z této třídy pro čtení konfigurace z externího zdroje, který chcete využívat v aplikaci .NET Framework pomocí standardního ConfigurationManager rozhraní API. ConfigurationBuilders jsou k dispozici na NuGet.org pro čtení z proměnných prostředí, azure key vaultu a řady dalších zdrojů.

Z NuGet.org je k dispozici několik implementací ConfigurationBuilders:

• EnvironmentConfigBuilder – čtení z proměnných prostředí.
• AzureKeyVaultConfigBuilder – Čtení z Azure Key Vault.
• UserSecretsConfigBuilder – čtení ze souboru usersecrets na disku, podobně jako funkce ASP.NET Core.
• SimpleJsonConfigBuilder – čtení ze souboru JSON.

Konstruktory

Vlastnosti

Metody

Platí pro