GlobalizationSection Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Define valores de configuración que se utilizan por compatibilidad con la infraestructura de globalización de las aplicaciones Web. Esta clase no puede heredarse.
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
- Herencia
Ejemplos
En este ejemplo se muestra cómo especificar valores declarativamente para varios atributos de la globalization
sección, a los que también se puede acceder como miembros de la GlobalizationSection clase .
En el ejemplo de archivo de configuración siguiente se muestra cómo especificar los valores declarativamente para la globalization
sección .
<system.web>
<globalization
requestEncoding="utf-8"
responseEncoding="utf-8"/>
</system.web>
En el ejemplo de código siguiente se muestra cómo usar la GlobalizationSection clase .
#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
Comentarios
La GlobalizationSection clase proporciona una manera de obtener acceso mediante programación y modificar el contenido de la globalization
sección del archivo de configuración.
Constructores
GlobalizationSection() |
Inicializa una nueva instancia de la clase GlobalizationSection utilizando las opciones predeterminadas. |
Propiedades
Culture |
Obtiene o establece un valor que especifica la referencia cultural predeterminada para procesar las solicitudes Web entrantes. |
CurrentConfiguration |
Obtiene una referencia a la instancia de Configuration de nivel superior que representa la jerarquía de configuración a la que pertenece la instancia actual de ConfigurationElement. (Heredado de ConfigurationElement) |
ElementInformation |
Obtiene un objeto ElementInformation que contiene la funcionalidad e información no personalizable del objeto ConfigurationElement. (Heredado de ConfigurationElement) |
ElementProperty |
Obtiene el objeto ConfigurationElementProperty que representa al propio objeto ConfigurationElement. (Heredado de ConfigurationElement) |
EnableBestFitResponseEncoding |
Obtiene o establece un valor que indica si se habilita la codificación de caracteres que mejor se ajuste para una respuesta. |
EnableClientBasedCulture |
Obtiene o establece un valor que indica si las propiedades Culture y UICulture deben basarse en el valor del campo AcceptLanguage del encabezado enviado por el explorador cliente. |
EvaluationContext |
Obtiene el objeto ContextInformation para el objeto ConfigurationElement. (Heredado de ConfigurationElement) |
FileEncoding |
Obtiene o establece un valor que especifica la codificación predeterminada para el análisis de archivos .aspx, .asmx y .asax. |
HasContext |
Obtiene un valor que indica si la propiedad CurrentConfiguration es |
Item[ConfigurationProperty] |
Obtiene o establece una propiedad o atributo de este elemento de configuración. (Heredado de ConfigurationElement) |
Item[String] |
Obtiene o establece una propiedad, un atributo o un elemento secundario de este elemento de configuración. (Heredado de ConfigurationElement) |
LockAllAttributesExcept |
Obtiene la colección de atributos bloqueados. (Heredado de ConfigurationElement) |
LockAllElementsExcept |
Obtiene la colección de elementos bloqueados. (Heredado de ConfigurationElement) |
LockAttributes |
Obtiene la colección de atributos bloqueados. (Heredado de ConfigurationElement) |
LockElements |
Obtiene la colección de elementos bloqueados. (Heredado de ConfigurationElement) |
LockItem |
Obtiene o establece un valor que indica si el elemento está bloqueado. (Heredado de ConfigurationElement) |
Properties |
Obtiene la colección de propiedades. (Heredado de ConfigurationElement) |
RequestEncoding |
Obtiene o establece un valor que especifica la codificación del contenido de las solicitudes HTTP. |
ResourceProviderFactoryType |
Obtiene o establece el tipo de fábrica del proveedor del recurso. |
ResponseEncoding |
Obtiene o establece un valor que especifica la codificación del contenido de las respuestas HTTP. |
ResponseHeaderEncoding |
Obtiene o establece un valor que especifica la codificación del encabezado de las respuestas HTTP. |
SectionInformation |
Obtiene un objeto SectionInformation que contiene la funcionalidad e información no personalizable del objeto ConfigurationSection. (Heredado de ConfigurationSection) |
UICulture |
Obtiene o establece un valor que especifica la referencia cultural predeterminada para procesar las búsquedas de recursos que dependen de la configuración regional. |
Métodos
DeserializeElement(XmlReader, Boolean) |
Lee XML del archivo de configuración. (Heredado de ConfigurationElement) |
DeserializeSection(XmlReader) |
Lee XML del archivo de configuración. (Heredado de ConfigurationSection) |
Equals(Object) |
Compara la instancia actual de ConfigurationElement con el objeto especificado. (Heredado de ConfigurationElement) |
GetHashCode() |
Obtiene un valor único que representa la instancia actual de ConfigurationElement. (Heredado de ConfigurationElement) |
GetRuntimeObject() |
Devuelve un objeto personalizado cuando se reemplaza en una clase derivada. (Heredado de ConfigurationSection) |
GetTransformedAssemblyString(String) |
Devuelve la versión transformada del nombre de ensamblado especificado. (Heredado de ConfigurationElement) |
GetTransformedTypeString(String) |
Devuelve la versión transformada del nombre de tipo especificado. (Heredado de ConfigurationElement) |
GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
Init() |
Establece el objeto ConfigurationElement en su estado inicial. (Heredado de ConfigurationElement) |
InitializeDefault() |
Se utiliza para inicializar un conjunto predeterminado de valores para el objeto ConfigurationElement. (Heredado de ConfigurationElement) |
IsModified() |
Indica si se ha modificado este elemento de configuración desde la última vez en que se guardo o cargó al implementarlo en una clase derivada. (Heredado de ConfigurationSection) |
IsReadOnly() |
Obtiene un valor que indica si el objeto ConfigurationElement es de solo lectura. (Heredado de ConfigurationElement) |
ListErrors(IList) |
Agrega a la lista que se pasa los errores de propiedad no válida que hay en este objeto ConfigurationElement y en todos los subelementos. (Heredado de ConfigurationElement) |
MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
OnDeserializeUnrecognizedAttribute(String, String) |
Obtiene un valor que indica si se ha encontrado un atributo desconocido durante la deserialización. (Heredado de ConfigurationElement) |
OnDeserializeUnrecognizedElement(String, XmlReader) |
Obtiene un valor que indica si se ha encontrado un elemento desconocido durante la deserialización. (Heredado de ConfigurationElement) |
OnRequiredPropertyNotFound(String) |
Se inicia una excepción cuando no se encuentra una propiedad necesaria. (Heredado de ConfigurationElement) |
PostDeserialize() |
Se llama a este método después de la deserialización. (Heredado de ConfigurationElement) |
PreSerialize(XmlWriter) |
Se llama a este método antes de la serialización. (Heredado de ConfigurationElement) |
Reset(ConfigurationElement) |
Restablece el estado interno del objeto ConfigurationElement, incluyendo los bloqueos y las colecciones de propiedades. (Heredado de ConfigurationElement) |
ResetModified() |
Restablece el valor del método IsModified() en |
SerializeElement(XmlWriter, Boolean) |
Escribe el contenido de este elemento de configuración en el archivo de configuración cuando se implementa en una clase derivada. (Heredado de ConfigurationElement) |
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode) |
Crea una cadena XML que contiene una vista separada del objeto ConfigurationSection como una sección única para escribir en un archivo. (Heredado de ConfigurationSection) |
SerializeToXmlElement(XmlWriter, String) |
Escribe las etiquetas externas de este elemento de configuración en el archivo de configuración cuando se implementa en una clase derivada. (Heredado de ConfigurationElement) |
SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Establece una propiedad en el valor especificado. (Heredado de ConfigurationElement) |
SetReadOnly() |
Establece la propiedad IsReadOnly() para el objeto ConfigurationElement y todos los subelementos. (Heredado de ConfigurationElement) |
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName) |
Indica si el elemento especificado se debe serializar cuando la jerarquía de objetos de configuración se serializa para la versión de destino especificada de .NET Framework. (Heredado de ConfigurationSection) |
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement) |
Indica si la propiedad especificada se debe serializar cuando la jerarquía de objetos de configuración se serializa para la versión de destino especificada de .NET Framework. (Heredado de ConfigurationSection) |
ShouldSerializeSectionInTargetVersion(FrameworkName) |
Indica si la instancia actual ConfigurationSection se debe serializar cuando la jerarquía de objetos de configuración se serializa para la versión de destino especificada de .NET Framework. (Heredado de ConfigurationSection) |
ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Modifica el objeto ConfigurationElement para quitar todos los valores que no se deben guardar. (Heredado de ConfigurationElement) |