using System;
using System.Collections.Specialized;

namespace System.Configuration
{
    // 摘要:
    //     提供对客户端应用程序配置文件的访问。无法继承此类。
    public static class ConfigurationManager
    {
        // 摘要:
        //     获取当前应用程序默认配置的 System.Configuration.AppSettingsSection 数据。
        //
        // 返回结果:
        //     返回一个 System.Collections.Specialized.NameValueCollection 对象，该对象包含当前应用程序默认配置的
        //     System.Configuration.AppSettingsSection 对象的内容。
        //
        // 异常:
        //   System.Configuration.ConfigurationErrorsException:
        //     无法使用应用程序设置数据检索 System.Collections.Specialized.NameValueCollection 对象。
        public static NameValueCollection AppSettings { get; }
        //
        // 摘要:
        //     获取当前应用程序默认配置的 System.Configuration.ConnectionStringsSection 数据。
        //
        // 返回结果:
        //     返回一个 System.Configuration.ConnectionStringSettingsCollection 对象，该对象包含当前应用程序默认配置的
        //     System.Configuration.ConnectionStringsSection 对象的内容。
        //
        // 异常:
        //   System.Configuration.ConfigurationErrorsException:
        //     无法检索 System.Configuration.ConnectionStringSettingsCollection 对象。
        public static ConnectionStringSettingsCollection ConnectionStrings { get; }

        // 摘要:
        //     检索当前应用程序默认配置的指定配置节。
        //
        // 参数:
        //   sectionName:
        //     配置节的路径和名称。
        //
        // 返回结果:
        //     指定的 System.Configuration.ConfigurationSection 对象，或者，如果该节不存在，则为 null。
        //
        // 异常:
        //   System.Configuration.ConfigurationErrorsException:
        //     未能加载配置文件。
        public static object GetSection(string sectionName);
        //
        // 摘要:
        //     将当前应用程序的配置文件作为 System.Configuration.Configuration 对象打开。
        //
        // 参数:
        //   userLevel:
        //     要打开配置的 System.Configuration.ConfigurationUserLevel。
        //
        // 返回结果:
        //     一个 System.Configuration.Configuration 对象。
        //
        // 异常:
        //   System.Configuration.ConfigurationErrorsException:
        //     未能加载配置文件。
        public static Configuration OpenExeConfiguration(ConfigurationUserLevel userLevel);
        //
        // 摘要:
        //     将指定的客户端配置文件作为 System.Configuration.Configuration 对象打开。
        //
        // 参数:
        //   exePath:
        //     配置文件的路径。配置文件与可执行文件位于同一目录中。
        //
        // 返回结果:
        //     一个 System.Configuration.Configuration 对象。
        //
        // 异常:
        //   System.Configuration.ConfigurationErrorsException:
        //     未能加载配置文件。
        public static Configuration OpenExeConfiguration(string exePath);
        //
        // 摘要:
        //     将当前计算机上的计算机配置文件作为 System.Configuration.Configuration 对象打开。
        //
        // 返回结果:
        //     一个 System.Configuration.Configuration 对象。
        //
        // 异常:
        //   System.Configuration.ConfigurationErrorsException:
        //     未能加载配置文件。
        public static Configuration OpenMachineConfiguration();
        //
        // 摘要:
        //     可将指定的客户端配置文件作为使用指定文件映射和用户级别的 System.Configuration.Configuration 对象打开。
        //
        // 参数:
        //   fileMap:
        //     一个 System.Configuration.ExeConfigurationFileMap 对象，该对象引用代替应用程序的默认配置文件使用的配置文件。
        //
        //   userLevel:
        //     要打开配置的 System.Configuration.ConfigurationUserLevel 对象。
        //
        // 返回结果:
        //     一个 System.Configuration.Configuration 对象。
        //
        // 异常:
        //   System.Configuration.ConfigurationErrorsException:
        //     未能加载配置文件。
        public static Configuration OpenMappedExeConfiguration(ExeConfigurationFileMap fileMap, ConfigurationUserLevel userLevel);
        //
        // 摘要:
        //     将计算机配置文件作为使用指定文件映射的 System.Configuration.Configuration 对象打开。
        //
        // 参数:
        //   fileMap:
        //     一个 System.Configuration.ExeConfigurationFileMap 对象，该对象引用代替应用程序的默认配置文件使用的配置文件。
        //
        // 返回结果:
        //     一个 System.Configuration.Configuration 对象。
        //
        // 异常:
        //   System.Configuration.ConfigurationErrorsException:
        //     未能加载配置文件。
        public static Configuration OpenMappedMachineConfiguration(ConfigurationFileMap fileMap);
        //
        // 摘要:
        //     刷新命名节，这样在下次检索它时将从磁盘重新读取它。
        //
        // 参数:
        //   sectionName:
        //     要刷新的节的配置节名称或配置路径和节名称。
        public static void RefreshSection(string sectionName);
    }
}