WebConfigurationManager.GetWebApplicationSection(String) Метод

Определение

Пространство имен:

System.Web.Configuration

Сборка:

System.Web.dll

Извлекает указанный раздел конфигурации из файла конфигурации текущего веб-приложения.

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 помощью метода.

Note

В этом примере показано, как использовать 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 вызывается из веб-приложения, он получает раздел из файла конфигурации, выбранного системой в соответствии с иерархией конфигурации веб-приложения.

Вы можете вызвать GetWebApplicationSection из клиентского приложения. В этом случае он получает раздел по умолчанию из файла конфигурации, выбранного системой в соответствии с иерархией конфигурации клиента. Как правило, это файл Machine.config, если вы не создали сопоставленную конфигурацию. Сведения о файлах конфигурации сопоставления см. в следующих методах сопоставления.

Note

Метод GetWebApplicationSection — это операция во время выполнения, которая действует в разделе файла конфигурации приложения, расположенного на текущем уровне. Однако GetSection метод не является операцией во время выполнения, но действует в указанном разделе, полученном с помощью одного из методов открытия файлов конфигурации.

Примечания для тех, кто наследует этот метод

Возвращаемое значение должно быть приведение к ожидаемому типу конфигурации перед использованием. Чтобы избежать возможных исключений приведения, следует использовать операцию условного приведения, например as оператор в C#.

См. также раздел

• ConfigurationSection