WebConfigurationManager.GetWebApplicationSection(String) 方法

定义

命名空间:

System.Web.Configuration

程序集:

System.Web.dll

从当前 Web 应用程序的配置文件中检索指定的配置节。

public:
 static System::Object ^ GetWebApplicationSection(System::String ^ sectionName);

public static object GetWebApplicationSection (string sectionName);

static member GetWebApplicationSection : string -> obj

Public Shared Function GetWebApplicationSection (sectionName As String) As Object

参数

sectionName

String

配置节名称。

返回

Object

指定的配置节对象，或 null（如果该节不存在），或某个内部对象（如果该节不能在运行时访问）。

例外

ConfigurationErrorsException

未能加载有效的配置文件。

示例

以下示例演示如何使用 GetWebApplicationSection 该方法访问配置信息。

备注

此示例演示如何使用 GetWebApplicationSection 该方法从默认配置文件获取 ConfigurationSection 对象。

// Show the use of GetWebApplicationSection(string). 
// to get the connectionStrings section.
 static void GetWebApplicationSection()
 {

     // Get the default connectionStrings section,
     ConnectionStringsSection connectionStringsSection =
         WebConfigurationManager.GetWebApplicationSection(
         "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 connectionStrings]");
     while (connectionStringsEnum.MoveNext())
     {
         string name = connectionStrings[i].Name;
         Console.WriteLine("Name: {0} Value: {1}",
         name, connectionStrings[name]);
         i += 1;
     }

     Console.WriteLine();
 }

' Show the use of GetWebApplicationSection(string). 
' to access the connectionStrings section.
Shared Sub GetWebApplicationSection()
   
   ' Get the default connectionStrings section,
     Dim connectionStringsSection As ConnectionStringsSection = _
     WebConfigurationManager.GetWebApplicationSection( _
     "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 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

注解

如果 GetWebApplicationSection 从 Web 应用程序中调用，则根据 Web 应用程序配置层次结构从系统选择的配置文件中获取该部分。

可以从客户端应用程序内部调用 GetWebApplicationSection 。 在这种情况下，它会根据客户端配置层次结构从系统选择的配置文件中获取默认部分。 通常，这是Machine.config文件，除非已就地配置映射。 有关映射配置文件，请参阅下一步所述的映射方法。

备注

该方法 GetWebApplicationSection 是一个运行时操作，用于处理位于当前级别的应用程序配置文件部分。 但是，该方法 GetSection 不是运行时操作，而是对通过打开配置文件的方法之一获取的指定节进行操作。

继承者说明

返回值必须在使用前转换为预期的配置类型。 若要避免可能的强制转换异常，应使用条件强制转换操作，如 as C# 中的运算符。

另请参阅

• ConfigurationSection