WebConfigurationManager Класс

Определение

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

System.Web.Configuration

Сборка:

System.Web.dll

Предоставляет доступ к файлам конфигурации при применении к веб-приложениям.

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

• Extending configuration standard types. Вы также можете предоставить пользовательские элементы конфигурации, расширив стандартные типы конфигурации, такие как ConfigurationElement, ConfigurationElementCollection, ConfigurationPropertyи ConfigurationSection , с помощью программной или атрибутивной модели. ConfigurationSection Пример расширения стандартного типа конфигурации программными средствами см. в классе . ConfigurationElement Пример расширения стандартного типа конфигурации с помощью модели с атрибутами см. в этом классе.

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

Класс Configuration обеспечивает программный доступ для редактирования файлов конфигурации. Вы используете один из открытых методов, предоставляемых WebConfigurationManager. Эти методы возвращают Configuration объект , который, в свою очередь, предоставляет необходимые методы и свойства для обработки базовых файлов конфигурации. Вы можете получить доступ к этим файлам для чтения или записи следующим образом:

Для чтения сведений о конфигурации используется GetSection(String) или GetSectionGroup(String) . Обратите внимание, что пользователь или процесс, который выполняет чтение, должен иметь следующие разрешения:

• Разрешение на чтение файла конфигурации на текущем уровне иерархии конфигурации.

• Разрешения на чтение для всех родительских файлов конфигурации.

Если приложению требуется доступ только для чтения к собственной конфигурации, рекомендуется использовать GetSection методы . Эти методы предоставляют доступ к кэшируемым значениям конфигурации для текущего приложения, которое имеет лучшую Configuration производительность, чем класс .

Примечание. Если используется статический GetSection метод, принимающий path параметр , параметр path должен ссылаться на приложение, в котором выполняется код; в противном случае параметр игнорируется и возвращаются сведения о конфигурации для текущего приложения.

Для записи сведений о конфигурации Save используется один из методов. Обратите внимание, что пользователь или процесс, который выполняет запись, должен иметь следующие разрешения:

• Разрешение на запись в файл конфигурации и каталог на текущем уровне иерархии конфигурации.

• Разрешения на чтение для всех файлов конфигурации.

Свойства

AppSettings	Получает параметры веб-приложения.
ConnectionStrings	Получает строки подключения веб-сайта.

Методы

GetSection(String)	Извлекает указанный раздел конфигурации из текущего файла конфигурации веб-приложения.
GetSection(String, String)	Извлекает указанный раздел конфигурации из файла конфигурации веб-приложения в заданном расположении.
GetWebApplicationSection(String)	Извлекает указанный раздел конфигурации из текущего файла конфигурации веб-приложения.
OpenMachineConfiguration()	Открывает файл конфигурации компьютера на текущем компьютере в качестве объекта Configuration для выполнения операций чтения или записи.
OpenMachineConfiguration(String)	Открывает файл конфигурации компьютера на текущем компьютере в качестве объекта Configuration для выполнения операций чтения или записи.
OpenMachineConfiguration(String, String)	Открывает указанный файл конфигурации компьютера на указанном сервере в качестве объекта Configuration для выполнения операций чтения или записи.
OpenMachineConfiguration(String, String, IntPtr)	Открывает указанный файл конфигурации компьютера на указанном сервере в качестве объекта Configuration с помощью указанного контекста безопасности для выполнения операций чтения или записи.
OpenMachineConfiguration(String, String, String, String)	Открывает указанный файл конфигурации компьютера на указанном сервере в качестве объекта Configuration с помощью указанного контекста безопасности для выполнения операций чтения или записи.
OpenMappedMachineConfiguration(ConfigurationFileMap)	Открывает файл конфигурации компьютера в качестве объекта Configuration с помощью указанного сопоставления файла для выполнения операций чтения или записи.
OpenMappedMachineConfiguration(ConfigurationFileMap, String)	Открывает файл конфигурации компьютера в качестве объекта Configuration с помощью указанного сопоставления и размещения файла для выполнения операций чтения или записи.
OpenMappedWebConfiguration(WebConfigurationFileMap, String)	Открывает указанный файл конфигурации веб-приложения в качестве объекта Configuration с помощью указанного сопоставления файла для выполнения операций чтения или записи.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String)	Открывает указанный файл конфигурации веб-приложения в качестве объекта Configuration с помощью указанного сопоставления файла, виртуального пути и имени сайта для выполнения операций чтения или записи.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String)	Открывает указанный файл конфигурации веб-приложения в качестве объекта Configuration с помощью указанного сопоставления файла, виртуального пути, имени сайта и расположения для выполнения операций чтения или записи.
OpenWebConfiguration(String)	Открывает файл конфигурации веб-приложения в качестве объекта Configuration с помощью указанного виртуального пути для выполнения операций чтения или записи.
OpenWebConfiguration(String, String)	Открывает файл конфигурации веб-приложения в качестве объекта Configuration с помощью указанного виртуального пути и имени сайта для выполнения операций чтения или записи.
OpenWebConfiguration(String, String, String)	Открывает файл конфигурации веб-приложения в качестве объекта Configuration с помощью указанного виртуального пути, имени сайта и расположения для выполнения операций чтения или записи.
OpenWebConfiguration(String, String, String, String)	Открывает файл конфигурации веб-приложения в качестве объекта Configuration с помощью указанного виртуального пути, имени сайта, расположения и сервера для выполнения операций чтения или записи.
OpenWebConfiguration(String, String, String, String, IntPtr)	Открывает файл конфигурации веб-приложения в качестве объекта Configuration с помощью указанного виртуального пути, имени сайта, расположения, сервера и контекста безопасности для выполнения операций чтения или записи.
OpenWebConfiguration(String, String, String, String, String, String)	Открывает файл конфигурации веб-приложения в качестве объекта Configuration с помощью указанного виртуального пути, имени сайта, расположения, сервера и контекста безопасности для выполнения операций чтения или записи.

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

• Configuration
• ConfigurationManager
• Общие сведения о конфигурации ASP.NET