GlobalizationSection Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Definiuje ustawienia konfiguracji używane do obsługi infrastruktury globalizacji aplikacji internetowych. Klasa ta nie może być dziedziczona.
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
- Dziedziczenie
Przykłady
W tym przykładzie pokazano, jak deklaratywnie określić wartości dla kilku atrybutów globalization sekcji, do których można również uzyskać dostęp jako elementy członkowskie GlobalizationSection klasy.
W poniższym przykładzie pliku konfiguracji pokazano, jak deklaratywnie określić wartości dla globalization sekcji.
<system.web>
<globalization
requestEncoding="utf-8"
responseEncoding="utf-8"/>
</system.web>
W poniższym przykładzie kodu pokazano, jak używać GlobalizationSection klasy .
#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
Uwagi
Klasa GlobalizationSection umożliwia programowy dostęp i modyfikowanie zawartości globalization sekcji pliku konfiguracji.
Konstruktory
| Nazwa | Opis |
|---|---|
| GlobalizationSection() |
Inicjuje GlobalizationSection nowe wystąpienie klasy przy użyciu ustawień domyślnych. |
Właściwości
| Nazwa | Opis |
|---|---|
| Culture |
Pobiera lub ustawia wartość określającą domyślną kulturę przetwarzania przychodzących żądań sieci Web. |
| CurrentConfiguration |
Pobiera odwołanie do wystąpienia najwyższego poziomu Configuration, które reprezentuje hierarchię konfiguracji, do którego należy bieżące wystąpienie ConfigurationElement. (Odziedziczone po ConfigurationElement) |
| ElementInformation |
Pobiera obiekt ElementInformation zawierający informacje i funkcje obiektu ConfigurationElement, które nie można dostosowywać. (Odziedziczone po ConfigurationElement) |
| ElementProperty |
Pobiera obiekt ConfigurationElementProperty reprezentujący sam obiekt ConfigurationElement. (Odziedziczone po ConfigurationElement) |
| EnableBestFitResponseEncoding |
Pobiera lub ustawia wartość wskazującą, czy jest włączone kodowanie znaków najlepiej pasujących do odpowiedzi. |
| EnableClientBasedCulture |
Pobiera lub ustawia wartość wskazującą, czy Culture właściwości i UICulture powinny być oparte na AcceptLanguage wartości pola nagłówka wysyłanej przez przeglądarkę klienta. |
| EvaluationContext |
Pobiera obiekt ContextInformation dla obiektu ConfigurationElement. (Odziedziczone po ConfigurationElement) |
| FileEncoding |
Pobiera lub ustawia wartość określającą domyślne kodowanie dla .aspx, asmx i .asax analizowania plików. |
| HasContext |
Pobiera wartość wskazującą, czy właściwość CurrentConfiguration jest |
| Item[ConfigurationProperty] |
Pobiera lub ustawia właściwość lub atrybut tego elementu konfiguracji. (Odziedziczone po ConfigurationElement) |
| Item[String] |
Pobiera lub ustawia właściwość, atrybut lub element podrzędny tego elementu konfiguracji. (Odziedziczone po ConfigurationElement) |
| LockAllAttributesExcept |
Pobiera kolekcję zablokowanych atrybutów. (Odziedziczone po ConfigurationElement) |
| LockAllElementsExcept |
Pobiera kolekcję zablokowanych elementów. (Odziedziczone po ConfigurationElement) |
| LockAttributes |
Pobiera kolekcję zablokowanych atrybutów. (Odziedziczone po ConfigurationElement) |
| LockElements |
Pobiera kolekcję zablokowanych elementów. (Odziedziczone po ConfigurationElement) |
| LockItem |
Pobiera lub ustawia wartość wskazującą, czy element jest zablokowany. (Odziedziczone po ConfigurationElement) |
| Properties |
Pobiera kolekcję właściwości. (Odziedziczone po ConfigurationElement) |
| RequestEncoding |
Pobiera lub ustawia wartość określającą kodowanie zawartości żądań HTTP. |
| ResourceProviderFactoryType |
Pobiera lub ustawia typ fabryki dostawcy zasobów. |
| ResponseEncoding |
Pobiera lub ustawia wartość określającą kodowanie zawartości odpowiedzi HTTP. |
| ResponseHeaderEncoding |
Pobiera lub ustawia wartość określającą kodowanie nagłówka odpowiedzi HTTP. |
| SectionInformation |
SectionInformation Pobiera obiekt, który zawiera informacje i funkcje ConfigurationSection obiektu, które nie można dostosowywać. (Odziedziczone po ConfigurationSection) |
| UICulture |
Pobiera lub ustawia wartość określającą domyślną kulturę przetwarzania wyszukiwania zasobów zależnych od ustawień regionalnych. |
Metody
| Nazwa | Opis |
|---|---|
| DeserializeElement(XmlReader, Boolean) |
Odczytuje kod XML z pliku konfiguracji. (Odziedziczone po ConfigurationElement) |
| DeserializeSection(XmlReader) |
Odczytuje kod XML z pliku konfiguracji. (Odziedziczone po ConfigurationSection) |
| Equals(Object) |
Porównuje bieżące ConfigurationElement wystąpienie z określonym obiektem. (Odziedziczone po ConfigurationElement) |
| GetHashCode() |
Pobiera unikatową wartość reprezentującą bieżące ConfigurationElement wystąpienie. (Odziedziczone po ConfigurationElement) |
| GetRuntimeObject() |
Zwraca obiekt niestandardowy podczas zastępowania w klasie pochodnej. (Odziedziczone po ConfigurationSection) |
| GetTransformedAssemblyString(String) |
Zwraca przekształconą wersję określonej nazwy zestawu. (Odziedziczone po ConfigurationElement) |
| GetTransformedTypeString(String) |
Zwraca przekształconą wersję określonej nazwy typu. (Odziedziczone po ConfigurationElement) |
| GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
| Init() |
Ustawia obiekt ConfigurationElement na stan początkowy. (Odziedziczone po ConfigurationElement) |
| InitializeDefault() |
Służy do inicjowania domyślnego zestawu wartości dla obiektu ConfigurationElement. (Odziedziczone po ConfigurationElement) |
| IsModified() |
Wskazuje, czy ten element konfiguracji został zmodyfikowany od czasu ostatniego zapisania, czy załadowany podczas implementacji w klasie pochodnej. (Odziedziczone po ConfigurationSection) |
| IsReadOnly() |
Pobiera wartość wskazującą, czy ConfigurationElement obiekt jest tylko do odczytu. (Odziedziczone po ConfigurationElement) |
| ListErrors(IList) |
Dodaje błędy nieprawidłowej właściwości w tym obiekcie ConfigurationElement i we wszystkich elementach podrzędnych do przekazanej listy. (Odziedziczone po ConfigurationElement) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany atrybut. (Odziedziczone po ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany element. (Odziedziczone po ConfigurationElement) |
| OnRequiredPropertyNotFound(String) |
Zgłasza wyjątek, gdy nie można odnaleźć wymaganej właściwości. (Odziedziczone po ConfigurationElement) |
| PostDeserialize() |
Wywoływana po deserializacji. (Odziedziczone po ConfigurationElement) |
| PreSerialize(XmlWriter) |
Wywoływana przed serializacji. (Odziedziczone po ConfigurationElement) |
| Reset(ConfigurationElement) |
Resetuje stan ConfigurationElement wewnętrzny obiektu, w tym blokady i kolekcje właściwości. (Odziedziczone po ConfigurationElement) |
| ResetModified() |
Resetuje wartość IsModified() metody w |
| SerializeElement(XmlWriter, Boolean) |
Zapisuje zawartość tego elementu konfiguracji w pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Odziedziczone po ConfigurationElement) |
| SerializeSection(ConfigurationElement, String, ConfigurationSaveMode) |
Tworzy ciąg XML zawierający niezaergowany widok ConfigurationSection obiektu jako pojedynczą sekcję do zapisu w pliku. (Odziedziczone po ConfigurationSection) |
| SerializeToXmlElement(XmlWriter, String) |
Zapisuje zewnętrzne tagi tego elementu konfiguracji do pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Odziedziczone po ConfigurationElement) |
| SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Ustawia właściwość na określoną wartość. (Odziedziczone po ConfigurationElement) |
| SetReadOnly() |
IsReadOnly() Ustawia właściwość dla ConfigurationElement obiektu i wszystkich podelementów. (Odziedziczone po ConfigurationElement) |
| ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName) |
Wskazuje, czy określony element powinien być serializowany, gdy hierarchia obiektów konfiguracji jest serializowana dla określonej wersji docelowej platformy .NET. (Odziedziczone po ConfigurationSection) |
| ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement) |
Wskazuje, czy określona właściwość powinna być serializowana, gdy hierarchia obiektów konfiguracji jest serializowana dla określonej wersji docelowej programu .NET Framework. (Odziedziczone po ConfigurationSection) |
| ShouldSerializeSectionInTargetVersion(FrameworkName) |
Wskazuje, czy bieżące wystąpienie ConfigurationSection powinno być serializowane, gdy hierarchia obiektów konfiguracji jest serializowana dla określonej wersji docelowej programu .NET Framework. (Odziedziczone po ConfigurationSection) |
| ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
| Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Modyfikuje obiekt, ConfigurationElement aby usunąć wszystkie wartości, które nie powinny być zapisywane. (Odziedziczone po ConfigurationElement) |