GlobalizationSection Класс

Определение

Пространство имен:: System.Web.Configuration

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Определяет параметры конфигурации, используемые для поддержки инфраструктуры глобализации веб-приложений. Этот класс не наследуется.

public ref class GlobalizationSection sealed : System::Configuration::ConfigurationSection

public sealed class GlobalizationSection : System.Configuration.ConfigurationSection

type GlobalizationSection = class
    inherit ConfigurationSection

Public NotInheritable Class GlobalizationSection
Inherits ConfigurationSection

Наследование: Object

ConfigurationElement

ConfigurationSection
GlobalizationSection

Примеры

В этом примере показано, как указывать значения декларативно для нескольких атрибутов globalization раздела, к которым также можно обращаться в качестве членов GlobalizationSection класса.

В следующем примере файла конфигурации показано, как указывать значения декларативно для globalization раздела.

<system.web>
  <globalization
    requestEncoding="utf-8"
    responseEncoding="utf-8"/>
</system.web>

В следующем примере кода показано, как использовать GlobalizationSection класс.

#region Using directives

using System;
using System.Collections.Generic;
using System.Text;
using System.Configuration;
using System.Web;
using System.Web.Configuration;

#endregion

namespace Samples.Aspnet.SystemWebConfiguration
{
  class UsingGlobalizationSection
  {
    static void Main(string[] args)
    {
      try
      {
        // Set the path of the config file.
        string configPath = "";

        // Get the Web application configuration object.
        Configuration config = WebConfigurationManager.OpenWebConfiguration(configPath);

        // Get the section related object.
        GlobalizationSection configSection =
          (GlobalizationSection)config.GetSection("system.web/globalization");

        // Display title and info.
        Console.WriteLine("ASP.NET Configuration Info");
        Console.WriteLine();

        // Display Config details.
        Console.WriteLine("File Path: {0}",
          config.FilePath);
        Console.WriteLine("Section Path: {0}",
          configSection.SectionInformation.Name);

        // Display Culture property.
        Console.WriteLine("Culture: {0}",
          configSection.Culture);
        
        // Set Culture property.
        configSection.Culture = 
          System.Globalization.CultureInfo.CurrentCulture.ToString();
         
        // Display EnableClientBasedCulture property.
        Console.WriteLine("EnableClientBasedCulture: {0}", 
          configSection.EnableClientBasedCulture);

        // Set EnableClientBasedCulture property.
        configSection.EnableClientBasedCulture = false;

        // Display FileEncoding property.
        Console.WriteLine("FileEncoding: {0}", 
          configSection.FileEncoding);

        // Set FileEncoding property.
        configSection.FileEncoding = 
          System.Text.Encoding.UTF8;

        // Display RequestEncoding property.
        Console.WriteLine("RequestEncoding: {0}",
          configSection.RequestEncoding);

        // Set RequestEncoding property.
        configSection.RequestEncoding = 
          System.Text.Encoding.UTF8;

        // Display ResponseEncoding property.
        Console.WriteLine("ResponseEncoding: {0}",
          configSection.ResponseEncoding);

        // Set ResponseEncoding property.
        configSection.ResponseEncoding = 
          System.Text.Encoding.UTF8;

        // Display ResponseHeaderEncoding property.
        Console.WriteLine("ResponseHeaderEncoding: {0}", 
          configSection.ResponseHeaderEncoding);

        // Set ResponseHeaderEncoding property.
        configSection.ResponseHeaderEncoding = 
          System.Text.Encoding.UTF8;

        // Display UICulture property.
        Console.WriteLine("UICulture: {0}",
          configSection.UICulture);

        // Set UICulture property.
         configSection.UICulture = 
           System.Globalization.CultureInfo.CurrentUICulture.ToString();

        // Update if not locked.
        if (!configSection.SectionInformation.IsLocked)
        {
          config.Save();
          Console.WriteLine("** Configuration updated.");
        }
        else
        {
          Console.WriteLine("** Could not update, section is locked.");
        }
      }

      catch (Exception e)
      {
        // Unknown error.
        Console.WriteLine(e.ToString());
      }

      // Display and wait
      Console.ReadLine();
    }
  }
}

Imports System.Collections.Generic
Imports System.Text
Imports System.Configuration
Imports System.Web
Imports System.Web.Configuration

Namespace Samples.Aspnet.SystemWebConfiguration
  Class UsingGlobalizationSection
    Public Shared Sub Main()
      Try
        ' Set the path of the config file.
        Dim configPath As String = ""

        ' Get the Web application configuration object.
        Dim config As System.Configuration.Configuration = _
         WebConfigurationManager.OpenWebConfiguration(configPath)

        ' Get the section related object.
        Dim configSection As System.Web.Configuration.GlobalizationSection = _
         CType(config.GetSection("system.web/globalization"), _
         System.Web.Configuration.GlobalizationSection)

        ' Display title and info.
        Console.WriteLine("ASP.NET Configuration Info")
        Console.WriteLine()

        ' Display Config details.
        Console.WriteLine("File Path: {0}", config.FilePath)
        Console.WriteLine("Section Path: {0}", configSection.SectionInformation.Name)

        ' Display Culture property.
        Console.WriteLine("Culture: {0}", _
         configSection.Culture)

        ' Set Culture property.
        configSection.Culture = _
         System.Globalization.CultureInfo.CurrentCulture.ToString()

        ' Display EnableClientBasedCulture property.
        Console.WriteLine("EnableClientBasedCulture: {0}", _
         configSection.EnableClientBasedCulture)

        ' Set EnableClientBasedCulture property.
        configSection.EnableClientBasedCulture = False

        ' Display FileEncoding property.
        Console.WriteLine("FileEncoding: {0}", _
         configSection.FileEncoding)

        ' Set FileEncoding property.
        configSection.FileEncoding = _
         System.Text.Encoding.UTF8

        ' Display RequestEncoding property.
        Console.WriteLine("RequestEncoding: {0}", _
         configSection.RequestEncoding)

        ' Set RequestEncoding property.
        configSection.RequestEncoding = _
         System.Text.Encoding.UTF8

        ' Display ResponseEncoding property.
        Console.WriteLine("ResponseEncoding: {0}", _
         configSection.ResponseEncoding)

        ' Set ResponseEncoding property.
        configSection.ResponseEncoding = _
         System.Text.Encoding.UTF8

        ' Display ResponseHeaderEncoding property.
        Console.WriteLine("ResponseHeaderEncoding: {0}", _
         configSection.ResponseHeaderEncoding)

        ' Set ResponseHeaderEncoding property.
        configSection.ResponseHeaderEncoding = _
         System.Text.Encoding.UTF8

        ' Display UICulture property.
        Console.WriteLine("UICulture: {0}", _
         configSection.UICulture)

        ' Set UICulture property.
        configSection.UICulture = _
         System.Globalization.CultureInfo.CurrentUICulture.ToString()

        ' Update if not locked.
        If Not configSection.SectionInformation.IsLocked Then
          config.Save()
          Console.WriteLine("** Configuration updated.")
        Else
          Console.WriteLine("** Could not update, section is locked.")
        End If

      Catch e As Exception
        ' Unknown error.
        Console.WriteLine(e.ToString())
      End Try

      ' Display and wait
      Console.ReadLine()
    End Sub
  End Class
End Namespace

Конструкторы

Имя	Описание
GlobalizationSection()	Инициализирует новый экземпляр GlobalizationSection класса с помощью параметров по умолчанию.

Свойства

Имя	Описание
Culture	Возвращает или задает значение, указывающее язык и региональные параметры по умолчанию для обработки входящих веб-запросов.
CurrentConfiguration	Возвращает ссылку на экземпляр верхнего уровня Configuration , представляющий иерархию конфигурации, к которой принадлежит текущий ConfigurationElement экземпляр. (Унаследовано от ConfigurationElement)
ElementInformation	ElementInformation Возвращает объект, содержащий не настраиваемую информацию и функциональные возможности ConfigurationElement объекта. (Унаследовано от ConfigurationElement)
ElementProperty	ConfigurationElementProperty Возвращает объект, представляющий ConfigurationElement сам объект. (Унаследовано от ConfigurationElement)
EnableBestFitResponseEncoding	Возвращает или задает значение, указывающее, включена ли кодировка символов, подходящая для ответа.
EnableClientBasedCulture	Возвращает или задает значение, указывающее, должны ли Culture UICulture свойства основываться на AcceptLanguage значении поля заголовка, которое отправляется клиентским браузером.
EvaluationContext	Возвращает объект ContextInformation для объекта ConfigurationElement. (Унаследовано от ConfigurationElement)
FileEncoding	Возвращает или задает значение, указывающее кодировку по умолчанию для синтаксического анализа .aspx, ASMX и ASAX-файла.
HasContext	Возвращает значение, указывающее, является CurrentConfigurationли `null` свойство. (Унаследовано от ConfigurationElement)
Item[ConfigurationProperty]	Возвращает или задает свойство или атрибут этого элемента конфигурации. (Унаследовано от ConfigurationElement)
Item[String]	Возвращает или задает свойство, атрибут или дочерний элемент этого элемента конфигурации. (Унаследовано от ConfigurationElement)
LockAllAttributesExcept	Возвращает коллекцию заблокированных атрибутов. (Унаследовано от ConfigurationElement)
LockAllElementsExcept	Возвращает коллекцию заблокированных элементов. (Унаследовано от ConfigurationElement)
LockAttributes	Возвращает коллекцию заблокированных атрибутов. (Унаследовано от ConfigurationElement)
LockElements	Возвращает коллекцию заблокированных элементов. (Унаследовано от ConfigurationElement)
LockItem	Возвращает или задает значение, указывающее, заблокирован ли элемент. (Унаследовано от ConfigurationElement)
Properties	Возвращает коллекцию свойств. (Унаследовано от ConfigurationElement)
RequestEncoding	Возвращает или задает значение, указывающее кодировку содержимого HTTP-запросов.
ResourceProviderFactoryType	Возвращает или задает тип фабрики поставщика ресурсов.
ResponseEncoding	Возвращает или задает значение, указывающее кодировку содержимого http-ответов.
ResponseHeaderEncoding	Возвращает или задает значение, указывающее кодировку заголовков http-ответов.
SectionInformation	SectionInformation Возвращает объект, содержащий не настраиваемую информацию и функциональные возможности ConfigurationSection объекта. (Унаследовано от ConfigurationSection)
UICulture	Возвращает или задает значение, указывающее язык и региональные параметры по умолчанию для обработки поиска ресурсов, зависимых от языкового стандарта.

Методы

Имя	Описание
DeserializeElement(XmlReader, Boolean)	Считывает XML из файла конфигурации. (Унаследовано от ConfigurationElement)
DeserializeSection(XmlReader)	Считывает XML из файла конфигурации. (Унаследовано от ConfigurationSection)
Equals(Object)	Сравнивает текущий ConfigurationElement экземпляр с указанным объектом. (Унаследовано от ConfigurationElement)
GetHashCode()	Возвращает уникальное значение, представляющее текущий ConfigurationElement экземпляр. (Унаследовано от ConfigurationElement)
GetRuntimeObject()	Возвращает пользовательский объект при переопределении в производном классе. (Унаследовано от ConfigurationSection)
GetTransformedAssemblyString(String)	Возвращает преобразованную версию указанного имени сборки. (Унаследовано от ConfigurationElement)
GetTransformedTypeString(String)	Возвращает преобразованную версию указанного имени типа. (Унаследовано от ConfigurationElement)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
Init()	Задает объект исходному ConfigurationElement состоянию. (Унаследовано от ConfigurationElement)
InitializeDefault()	Используется для инициализации набора значений по умолчанию для ConfigurationElement объекта. (Унаследовано от ConfigurationElement)
IsModified()	Указывает, был ли изменен этот элемент конфигурации с момента последнего сохранения или загрузки при реализации в производном классе. (Унаследовано от ConfigurationSection)
IsReadOnly()	Возвращает значение, указывающее, доступен ли ConfigurationElement объект только для чтения. (Унаследовано от ConfigurationElement)
ListErrors(IList)	Добавляет ошибки недопустимого свойства в этом ConfigurationElement объекте и во все подэлементы в переданный список. (Унаследовано от ConfigurationElement)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnDeserializeUnrecognizedAttribute(String, String)	Возвращает значение, указывающее, обнаружен ли неизвестный атрибут во время десериализации. (Унаследовано от ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Возвращает значение, указывающее, обнаружен ли неизвестный элемент во время десериализации. (Унаследовано от ConfigurationElement)
OnRequiredPropertyNotFound(String)	Создает исключение, если обязательное свойство не найдено. (Унаследовано от ConfigurationElement)
PostDeserialize()	Вызывается после десериализации. (Унаследовано от ConfigurationElement)
PreSerialize(XmlWriter)	Вызывается перед сериализацией. (Унаследовано от ConfigurationElement)
Reset(ConfigurationElement)	Сбрасывает внутреннее состояние ConfigurationElement объекта, включая блокировки и коллекции свойств. (Унаследовано от ConfigurationElement)
ResetModified()	Сбрасывает значение IsModified() метода `false` на момент реализации в производном классе. (Унаследовано от ConfigurationSection)
SerializeElement(XmlWriter, Boolean)	Записывает содержимое этого элемента конфигурации в файл конфигурации при реализации в производном классе. (Унаследовано от ConfigurationElement)
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)	Создает XML-строку, содержащую несоединённое представление ConfigurationSection объекта в виде одного раздела для записи в файл. (Унаследовано от ConfigurationSection)
SerializeToXmlElement(XmlWriter, String)	Записывает внешние теги этого элемента конфигурации в файл конфигурации при реализации в производном классе. (Унаследовано от ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Задает свойству указанное значение. (Унаследовано от ConfigurationElement)
SetReadOnly()	IsReadOnly() Задает свойство для ConfigurationElement объекта и всех вложенных элементов. (Унаследовано от ConfigurationElement)
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)	Указывает, следует ли сериализовать указанный элемент при сериализации иерархии объектов конфигурации для указанной целевой версии .NET Framework. (Унаследовано от ConfigurationSection)
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)	Указывает, следует ли сериализовать указанное свойство при сериализации иерархии объектов конфигурации для указанной целевой версии платформы .NET Framework. (Унаследовано от ConfigurationSection)
ShouldSerializeSectionInTargetVersion(FrameworkName)	Указывает, следует ли сериализовать текущий экземпляр ConfigurationSection при сериализации иерархии объектов конфигурации для указанной целевой версии платформы .NET Framework. (Унаследовано от ConfigurationSection)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Изменяет объект для удаления всех значений ConfigurationElement , которые не должны быть сохранены. (Унаследовано от ConfigurationElement)

Применяется к

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

Обратная связь

Были ли сведения на этой странице полезными?