Converter Classe

Definição

Espaço de Nomes:: System.Web.Configuration

Assemblagem:: System.Web.Extensions.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Representa um elemento de configuração num ficheiro de configuração.

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

public class Converter : System.Configuration.ConfigurationElement

type Converter = class
    inherit ConfigurationElement

Public Class Converter
Inherits ConfigurationElement

Herança: Object

ConfigurationElement
Converter

Exemplos

O excerto seguinte do ficheiro de configuração mostra como especificar declarativamente valores para propriedades da Converter classe.

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

O exemplo seguinte demonstra como aceder Converter programaticamente.

// 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

Observações

A classe Converter permite-lhe aceder e modificar programaticamente as definições de configuração relacionadas com conversores usados por aplicações de ASP.NET com AJAX.

Para criar funcionalidade de conversão personalizada, podes criar uma classe que herde da JavaScriptConverter classe. Depois de criado o conversor, pode registá-lo para uso no ficheiro de configuração da sua aplicação Web.

Construtores

Name	Description
Converter()	Inicializa uma nova instância da Converter classe.

Propriedades

Name	Description
CurrentConfiguration	Obtém uma referência à instância de topo Configuration que representa a hierarquia de configuração a que pertence a instância atual ConfigurationElement . (Herdado de ConfigurationElement)
ElementInformation	Obtém um ElementInformation objeto que contém a informação e funcionalidade não personalizáveis do ConfigurationElement objeto. (Herdado de ConfigurationElement)
ElementProperty	Obtém o ConfigurationElementProperty objeto que representa o ConfigurationElement próprio objeto. (Herdado de ConfigurationElement)
EvaluationContext	Obtém o ContextInformation objeto para o ConfigurationElement objeto. (Herdado de ConfigurationElement)
HasContext	Obtém um valor que indica se a CurrentConfiguration propriedade é `null`. (Herdado de ConfigurationElement)
Item[ConfigurationProperty]	Obtém ou define uma propriedade ou atributo deste elemento de configuração. (Herdado de ConfigurationElement)
Item[String]	Obtém ou define uma propriedade, atributo ou elemento filho deste elemento de configuração. (Herdado de ConfigurationElement)
LockAllAttributesExcept	Obtém a coleção de atributos bloqueados. (Herdado de ConfigurationElement)
LockAllElementsExcept	Obtém a coleção de elementos bloqueados. (Herdado de ConfigurationElement)
LockAttributes	Obtém a coleção de atributos bloqueados. (Herdado de ConfigurationElement)
LockElements	Obtém a coleção de elementos bloqueados. (Herdado de ConfigurationElement)
LockItem	Recebe ou define um valor que indica se o elemento está bloqueado. (Herdado de ConfigurationElement)
Name	Obtém ou define o identificador único para o conversor.
Properties	Obtém uma coleção de propriedades dos elementos de configuração.
Type	Obtém ou define o nome de tipo totalmente qualificado do JavaScriptConverter objeto.

Métodos

Name	Description
DeserializeElement(XmlReader, Boolean)	Lê XML a partir do ficheiro de configuração. (Herdado de ConfigurationElement)
Equals(Object)	Compara a instância atual ConfigurationElement com o objeto especificado. (Herdado de ConfigurationElement)
GetHashCode()	Obtém um valor único que representa a instância atual ConfigurationElement . (Herdado de ConfigurationElement)
GetTransformedAssemblyString(String)	Devolve a versão transformada do nome da assembleia especificado. (Herdado de ConfigurationElement)
GetTransformedTypeString(String)	Devolve a versão transformada do nome do tipo especificado. (Herdado de ConfigurationElement)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
Init()	Define o ConfigurationElement objeto para o seu estado inicial. (Herdado de ConfigurationElement)
InitializeDefault()	Usado para inicializar um conjunto padrão de valores para o ConfigurationElement objeto. (Herdado de ConfigurationElement)
IsModified()	Indica se este elemento de configuração foi modificado desde a última vez que foi guardado ou carregado, quando implementado numa classe derivada. (Herdado de ConfigurationElement)
IsReadOnly()	Recebe um valor que indica se o ConfigurationElement objeto é apenas de leitura. (Herdado de ConfigurationElement)
ListErrors(IList)	Adiciona os erros de propriedades inválidas neste ConfigurationElement objeto, e em todos os subelementos, à lista passada. (Herdado de ConfigurationElement)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
OnDeserializeUnrecognizedAttribute(String, String)	Recebe um valor que indica se um atributo desconhecido é encontrado durante a desserialização. (Herdado de ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Obtém um valor que indica se um elemento desconhecido é encontrado durante a desserialização. (Herdado de ConfigurationElement)
OnRequiredPropertyNotFound(String)	Lança uma exceção quando uma propriedade exigida não é encontrada. (Herdado de ConfigurationElement)
PostDeserialize()	Chamada após desserialização. (Herdado de ConfigurationElement)
PreSerialize(XmlWriter)	Chamado antes da serialização. (Herdado de ConfigurationElement)
Reset(ConfigurationElement)	Reinicia o estado interno do ConfigurationElement objeto, incluindo os bloqueios e as coleções de propriedades. (Herdado de ConfigurationElement)
ResetModified()	Redefine o valor do IsModified() método para `false` quando implementado numa classe derivada. (Herdado de ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Escreve o conteúdo deste elemento de configuração no ficheiro de configuração quando implementado numa classe derivada. (Herdado de ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Escreve as etiquetas exteriores deste elemento de configuração no ficheiro de configuração quando implementado numa classe derivada. (Herdado de ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Define uma propriedade para o valor especificado. (Herdado de ConfigurationElement)
SetReadOnly()	Define a IsReadOnly() propriedade para o ConfigurationElement objeto e todos os subelementos. (Herdado de ConfigurationElement)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modifica o ConfigurationElement objeto para remover todos os valores que não deveriam ser guardados. (Herdado de ConfigurationElement)

Aplica-se a

Ver também

JavaScriptConverter

Comentários

Esta página foi útil?