WebConfigurationManager 类

定义

public ref class WebConfigurationManager abstract sealed

public static class WebConfigurationManager

type WebConfigurationManager = class

Public Class WebConfigurationManager

继承

Object

WebConfigurationManager

示例

以下示例演示如何使用 访问配置信息

GetSection 方法。

// Show how to use the GetSection(string).
// to access the connectionStrings section.
static void GetConnectionStringsSection()
{

    // Get the connectionStrings section.
    ConnectionStringsSection connectionStringsSection =
        WebConfigurationManager.GetSection("connectionStrings")
        as ConnectionStringsSection;

    // Get the connectionStrings key,value pairs collection.
    ConnectionStringSettingsCollection connectionStrings =
        connectionStringsSection.ConnectionStrings;

    // Get the collection enumerator.
    IEnumerator connectionStringsEnum =
        connectionStrings.GetEnumerator();

    // Loop through the collection and
    // display the connectionStrings key, value pairs.
    int i = 0;
    Console.WriteLine("[Display the connectionStrings]");
    while (connectionStringsEnum.MoveNext())
    {
        string name = connectionStrings[i].Name;
        Console.WriteLine("Name: {0} Value: {1}",
        name, connectionStrings[name]);
        i += 1;
    }

    Console.WriteLine();
}

' Show how to use the GetSection(string). 
' to access the connectionStrings section.
Shared Sub GetConnectionStringsSection()
   
   ' Get the connectionStrings section.
     Dim connectionStringsSection As ConnectionStringsSection = _
     WebConfigurationManager.GetSection("connectionStrings")
   
   ' Get the connectionStrings key,value pairs collection.
     Dim connectionStrings As ConnectionStringSettingsCollection = _
     connectionStringsSection.ConnectionStrings
   
   ' Get the collection enumerator.
     Dim connectionStringsEnum As IEnumerator = _
     connectionStrings.GetEnumerator()
   
   ' Loop through the collection and 
   ' display the connectionStrings key, value pairs.
   Dim i As Integer = 0
   Console.WriteLine("[Display the connectionStrings]")
   While connectionStringsEnum.MoveNext()
      Dim name As String = connectionStrings(i).Name
         Console.WriteLine("Name: {0} Value: {1}", _
         name, connectionStrings(name))
      i += 1
   End While
   
   Console.WriteLine()
End Sub

注解

该 WebConfigurationManager 类允许你访问计算机和应用程序信息。

使用 WebConfigurationManager 是处理与 Web 应用程序相关的配置文件的首选方法。 对于客户端应用程序，请使用 ConfigurationManager 类。

应用程序可以扩展 System.Configuration 类型或使用它们直接处理配置信息，如以下列表所述：

• Handling configuration。 若要使用标准类型处理配置信息，请使用以下方法之一：

  • Accessing a section。 若要访问应用程序的配置信息，必须使用其中一GetSection种方法。WebConfigurationManager 对于 <appSettings> 和 <connectionStrings>，可以使用 AppSettings 和 ConnectionStrings 属性。 这些方法执行只读操作，使用配置的单个缓存实例，并且具有多线程感知。

  • Accessing configuration files。 应用程序可以在任何级别读取和写入配置设置，供自身或其他应用程序或计算机在本地或远程读取和写入。 使用 open提供的 WebConfigurationManager 方法之一。 这些方法将返回一个 Configuration 对象，该对象又提供处理基础配置文件所需的方法和属性。 这些方法执行读取或写入操作，并在每次打开文件时重新创建配置数据。

  • Advanced configuration。 类型、SectionInformation、PropertyInformation、PropertyInformationCollection、ElementInformation和ContextInformationConfigurationSectionGroup类型提供了ConfigurationSectionGroupCollection更高级的配置处理。

• Extending configuration standard types。 还可以通过扩展标准配置类型（例如 ConfigurationElement， ConfigurationElementCollection） ConfigurationProperty以及 ConfigurationSection 使用编程或特性化模型来提供自定义配置元素。 ConfigurationSection有关如何以编程方式扩展标准配置类型的示例，请参阅该类。 ConfigurationElement有关如何使用特性化模型扩展标准配置类型的示例，请参阅该类。

继承者说明

该 Configuration 类允许以编程方式访问编辑配置文件。 使用由 WebConfigurationManager其中一个提供的开放方法。 这些方法将返回一个 Configuration 对象，该对象又提供处理基础配置文件所需的方法和属性。 可按如下所示访问这些文件进行读取或写入：

使用 GetSection(String) 或 GetSectionGroup(String) 读取配置信息。 请注意，读取的用户或进程必须具有以下权限：

• 对当前配置层次结构级别的配置文件的读取权限。

• 读取所有父配置文件的权限。

如果应用程序需要对其自己的配置进行只读访问权限，建议使用 GetSection 该方法。 这些方法提供对当前应用程序的缓存配置值的访问权限，其性能优于 Configuration 类。

注意：如果使用采用GetSection参数的静态path方法，路径参数必须引用运行代码的应用程序;否则，将忽略该参数，并返回当前正在运行的应用程序的配置信息。

可以使用其中 Save 一种方法来编写配置信息。 请注意，写入的用户或进程必须具有以下权限：

• 对当前配置层次结构级别的配置文件和目录的写入权限。

• 读取所有配置文件的权限。

另请参阅

• Configuration
• ConfigurationManager
• ASP.NET 配置概述