Converter Clase

Definición

Espacio de nombres:

System.Web.Configuration

Ensamblado:

System.Web.Extensions.dll

Representa un elemento de configuración en un archivo de configuración.

public ref class Converter : System::Configuration::ConfigurationElement

public class Converter : System.Configuration.ConfigurationElement

type Converter = class
    inherit ConfigurationElement

Public Class Converter
Inherits ConfigurationElement

Herencia

Object

ConfigurationElement

Converter

Ejemplos

El siguiente extracto del archivo de configuración muestra cómo especificar de forma declarativa valores para las propiedades de la Converter clase .

<system.web.extensions>  
  <scripting>  
    <webServices>  
      <jsonSerialization>  
        <converters>  
          <add name="ConvertMe" type="Acme.SubAcme.ConvertMeTypeConverter" />  
        </converters>  
      </jsonSerialization>  
    </webServices>  
  </scripting>  
</system.web.extensions>  

En el ejemplo siguiente se muestra cómo acceder Converter mediante programación.

// Get the Web application configuration.
System.Configuration.Configuration configuration =
    WebConfigurationManager.OpenWebConfiguration("/aspnetTest");

// Get the external JSON section.
ScriptingJsonSerializationSection jsonSection =
    (ScriptingJsonSerializationSection)configuration.GetSection(
    "system.web.extensions/scripting/webServices/jsonSerialization");

//Get the converters collection.
ConvertersCollection converters =
    jsonSection.Converters;

if ((converters != null) && converters.Count > 0)
{
    // Get the first registered converter.
    Converter converterElement = converters[0];
}

' Get the Web application configuration.
Dim configuration As System.Configuration.Configuration = _
    WebConfigurationManager.OpenWebConfiguration("/aspnetTest")

' Get the external JSON section.
Dim jsonSection As ScriptingJsonSerializationSection = _
    CType(configuration.GetSection( _
        "system.web.extensions/scripting/webServices/jsonSerialization"), _
        ScriptingJsonSerializationSection)

'Get the converters collection.
Dim converters As ConvertersCollection = _
    jsonSection.Converters

If Not (converters Is Nothing) AndAlso _
    converters.Count > 0 Then
    ' Get the first registered converter.
    Dim converterElement As Converter = converters(0)
End If

Comentarios

La clase Converter permite acceder mediante programación y modificar las opciones de configuración relacionadas con convertidores que usan las aplicaciones de ASP.NET habilitadas para AJAX.

Para crear una funcionalidad de conversión personalizada, puede crear una clase que herede de la JavaScriptConverter clase . Una vez creado el convertidor, puede registrarlo para usarlo en el archivo de configuración de la aplicación web.

Constructores

Nombre	Description
Converter()	Inicializa una nueva instancia de la clase Converter.

Propiedades

Nombre	Description
CurrentConfiguration	Obtiene una referencia a la instancia de nivel Configuration superior que representa la jerarquía de configuración a la que pertenece la instancia actual ConfigurationElement . (Heredado de ConfigurationElement)
ElementInformation	Obtiene un ElementInformation objeto que contiene la información y la funcionalidad no personalizables del ConfigurationElement objeto . (Heredado de ConfigurationElement)
ElementProperty	Obtiene el ConfigurationElementProperty objeto que representa el ConfigurationElement propio objeto. (Heredado de ConfigurationElement)
EvaluationContext	Obtiene el objeto ContextInformation para el objeto ConfigurationElement. (Heredado de ConfigurationElement)
HasContext	Obtiene un valor que indica si la CurrentConfiguration propiedad es null. (Heredado de ConfigurationElement)
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)
Name	Obtiene o establece el identificador único del convertidor.
Properties	Obtiene una colección de propiedades de elemento de configuración.
Type	Obtiene o establece el nombre de tipo completo del JavaScriptConverter objeto.

Métodos

Nombre	Description
DeserializeElement(XmlReader, Boolean)	Lee XML del archivo de configuración. (Heredado de ConfigurationElement)
Equals(Object)	Compara la instancia actual ConfigurationElement con el objeto especificado. (Heredado de ConfigurationElement)
GetHashCode()	Obtiene un valor único que representa la instancia actual ConfigurationElement . (Heredado de ConfigurationElement)
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 ConfigurationElement objeto en su estado inicial. (Heredado de ConfigurationElement)
InitializeDefault()	Se usa para inicializar un conjunto predeterminado de valores para el ConfigurationElement objeto . (Heredado de ConfigurationElement)
IsModified()	Indica si este elemento de configuración se ha modificado desde que se guardó o cargó por última vez, cuando se implementó en una clase derivada. (Heredado de ConfigurationElement)
IsReadOnly()	Obtiene un valor que indica si el ConfigurationElement objeto es de solo lectura. (Heredado de ConfigurationElement)
ListErrors(IList)	Agrega los errores de propiedad no válida en este ConfigurationElement objeto y, en todos los subelementos, a la lista pasada. (Heredado de ConfigurationElement)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
OnDeserializeUnrecognizedAttribute(String, String)	Obtiene un valor que indica si se encuentra un atributo desconocido durante la deserialización. (Heredado de ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Obtiene un valor que indica si se encuentra un elemento desconocido durante la deserialización. (Heredado de ConfigurationElement)
OnRequiredPropertyNotFound(String)	Produce una excepción cuando no se encuentra una propiedad necesaria. (Heredado de ConfigurationElement)
PostDeserialize()	Se llama después de la deserialización. (Heredado de ConfigurationElement)
PreSerialize(XmlWriter)	Se llama antes de la serialización. (Heredado de ConfigurationElement)
Reset(ConfigurationElement)	Restablece el estado interno del ConfigurationElement objeto, incluidos los bloqueos y las colecciones de propiedades. (Heredado de ConfigurationElement)
ResetModified()	Restablece el valor del IsModified() método a false cuando se implementa en una clase derivada. (Heredado de ConfigurationElement)
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)
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 IsReadOnly() propiedad para el ConfigurationElement objeto y todos los subelementos. (Heredado de ConfigurationElement)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modifica el ConfigurationElement objeto para quitar todos los valores que no se deben guardar. (Heredado de ConfigurationElement)

Consulte también

• JavaScriptConverter