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

Примечание

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

Примечание

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

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

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

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

• ConfigurationSection