WebConfigurationManager 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
在配置文件应用于 Web 应用程序时提供对配置文件的访问。
public ref class WebConfigurationManager abstract sealedpublic static class WebConfigurationManagertype WebConfigurationManager = classPublic Class WebConfigurationManager- 继承
-
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. 若要访问应用程序的配置信息，必须使用 提供WebConfigurationManager的方法之GetSection一。 对于<appSettings>和<connectionStrings>，请使用 AppSettings 和 ConnectionStrings 属性。 这些方法执行只读操作，使用配置的单个缓存实例，并且可识别多线程。Accessing configuration files. 应用程序可以在任何级别（本地或远程）为自身或其他应用程序或计算机读取和写入配置设置。 使用 提供WebConfigurationManager的方法之open一。 这些方法将返回一个 Configuration 对象，该对象反过来又提供处理基础配置文件所需的方法和属性。 这些方法执行读取或写入操作，并在每次打开文件时重新创建配置数据。Advanced configuration. 类型 、、、PropertyInformation、PropertyInformationCollectionContextInformationElementInformation、 ConfigurationSectionGroup和 ConfigurationSectionGroupCollection提供了SectionInformation更高级的配置处理。
Extending configuration standard types. 还可以通过使用编程模型或特性化模型扩展标准配置类型（如 ConfigurationElement、 ConfigurationElementCollection、 ConfigurationProperty和 ConfigurationSection ）来提供自定义配置元素。 ConfigurationSection有关如何以编程方式扩展标准配置类型的示例，请参阅 类。 有关如何 ConfigurationElement 使用特性化模型扩展标准配置类型的示例，请参阅 类。
继承者说明
类 Configuration 允许以编程方式访问编辑配置文件。 使用 提供的 WebConfigurationManager打开方法之一。 这些方法将返回一个 Configuration 对象，该对象反过来又提供处理基础配置文件所需的方法和属性。 可以访问这些文件进行读取或写入，如下所示：
使用 GetSection(String) 或 GetSectionGroup(String) 读取配置信息。 请注意，读取的用户或进程必须具有以下权限：
对当前配置层次结构级别的配置文件的读取权限。
对所有父配置文件的读取权限。
如果应用程序需要对其自己的配置进行只读访问，建议使用 GetSection 方法。 这些方法提供对当前应用程序的缓存配置值的访问权限，该应用程序的性能优于 Configuration 类。
注意：如果使用采用path参数的静态GetSection方法，则路径参数必须引用运行代码的应用程序;否则，将忽略参数并返回当前正在运行的应用程序的配置信息。
使用其中 Save 一种方法来编写配置信息。 请注意，写入的用户或进程必须具有以下权限：
对当前配置层次结构级别的配置文件和目录的写入权限。
对所有配置文件的读取权限。
属性
| AppSettings |
获取该网站的应用程序设置。 |
| ConnectionStrings |
获取网站的连接字符串。 |
方法
适用于
另请参阅
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈