TagMapInfo Classe

Referência

Definição

Namespace:: System.Web.Configuration

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Contém uma marca única de configuração que remapeia a instrução. Essa classe não pode ser herdada.

public ref class TagMapInfo sealed : System::Configuration::ConfigurationElement

public sealed class TagMapInfo : System.Configuration.ConfigurationElement

type TagMapInfo = class
    inherit ConfigurationElement

Public NotInheritable Class TagMapInfo
Inherits ConfigurationElement

Herança: Object

ConfigurationElement
TagMapInfo

Exemplos

O trecho do arquivo de configuração a seguir mostra como especificar valores declarativamente para várias propriedades da TagMapInfo classe.

<system.web>  
  <pages>  
    <tagMapping>  
      <add  
        tagType=  
          "System.Web.UI.WebControls.WebParts.WebPartManager"  
        mappedTagType=  
          "Microsoft.Sharepoint.WebPartPartManager,   
           MSPS.Web.dll, Version='2.0.0.0'"   
      />  
    </tagMapping>  
  </pages>  
</system.web>

O exemplo de código a seguir mostra como usar a TagMapCollection classe para modificar programaticamente as configurações de mapeamento de marca. Este exemplo de código faz parte de um exemplo maior fornecido para a PagesSection classe.

// Get all current TagMappings in the collection.
for (int i = 0; i < pagesSection.TagMapping.Count; i++)
{
  Console.WriteLine("TagMapping {0}:", i);
  Console.WriteLine("  TagTypeName = '{0}'",
      pagesSection.TagMapping[i].TagType);
  Console.WriteLine("  MappedTagTypeName = '{0}'",
      pagesSection.TagMapping[i].MappedTagType);
}

// Add a TagMapInfo object using a constructor.
pagesSection.TagMapping.Add(
    new System.Web.Configuration.TagMapInfo(
    "MyNameSpace.MyControl", "MyNameSpace.MyOtherControl"));

' Get all current TagMappings in the collection.
Dim k As Int32
For k = 1 To pagesSection.TagMapping.Count
  Console.WriteLine("TagMapping {0}:", i)
  Console.WriteLine("  TagTypeName = '{0}'", _
   pagesSection.TagMapping(k).TagType)
  Console.WriteLine("  MappedTagTypeName = '{0}'", _
   pagesSection.TagMapping(k).MappedTagType)
Next

' Add a TagMapInfo object using a constructor.
pagesSection.TagMapping.Add( _
 New System.Web.Configuration.TagMapInfo( _
 "MyNameSpace.MyControl", "MyNameSpace.MyOtherControl"))

Comentários

A TagMapInfo classe permite que você remapee os tipos de marcas em tempo de compilação. Esse remapping faz com que o tipo mapeado seja usado no lugar do tipo de marca original para todas as páginas e controles no aplicativo ASP.NET no escopo do arquivo de configuração.

A TagMapCollection classe permite que você acesse e modifique programaticamente a tagMapping subseção da pages seção de um arquivo de configuração. tagMappings Na subseção, você pode adicionar e remover mapeamentos entre tipos de marca especificando os nomes fortes totalmente qualificados dos tipos.

Observação

Ao contrário de outros atributos e coleções na seção, o pages remapeamento de marca não tem nenhuma diretiva de página de ASP.NET correspondente.

Construtores

TagMapInfo(String, String)

Inicializa uma nova instância da classe TagMapInfo com base nos valores de propriedade passados.

Propriedades

CurrentConfiguration	Obtém uma referência para a instância Configuration de nível superior que representa a hierarquia de configuração à qual a instância atual ConfigurationElement pertence. (Herdado de ConfigurationElement)
ElementInformation	Obtém um objeto ElementInformation que contém as informações não personalizáveis e a funcionalidade do objeto ConfigurationElement. (Herdado de ConfigurationElement)
ElementProperty	Obtém o objeto ConfigurationElementProperty que representa o próprio objeto ConfigurationElement. (Herdado de ConfigurationElement)
EvaluationContext	Obtém o objeto ContextInformation para o objeto ConfigurationElement. (Herdado de ConfigurationElement)
HasContext	Obtém um valor que indica se a propriedade CurrentConfiguration é `null`. (Herdado de ConfigurationElement)
Item[ConfigurationProperty]	Obtém ou define uma propriedade ou um atributo desse elemento de configuração. (Herdado de ConfigurationElement)
Item[String]	Obtém ou define uma propriedade, atributo ou elemento filho desse 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	Obtém ou define um valor que indica se o elemento está bloqueado. (Herdado de ConfigurationElement)
MappedTagType	Obtém ou define o nome do tipo do qual a marca é remapeada.
Properties	Obtém a coleção de propriedades. (Herdado de ConfigurationElement)
TagType	Obtém ou define o nome do tipo original para a marca que está sendo remapeada.

Métodos

DeserializeElement(XmlReader, Boolean)	Lê o XML do arquivo de configuração. (Herdado de ConfigurationElement)
Equals(Object)	Compara a essa instância a outro objeto.
GetHashCode()	Retorna um valor de hash para a instância atual.
GetTransformedAssemblyString(String)	Retorna a versão transformada do nome do assembly especificado. (Herdado de ConfigurationElement)
GetTransformedTypeString(String)	Retorna 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 objeto ConfigurationElement para seu estado inicial. (Herdado de ConfigurationElement)
InitializeDefault()	Usado para inicializar um conjunto padrão de valores para o objeto ConfigurationElement. (Herdado de ConfigurationElement)
IsModified()	Indica se este elemento de configuração foi modificado desde a última vez em que foi salvo ou carregado quando implementado em uma classe derivada. (Herdado de ConfigurationElement)
IsReadOnly()	Obtém um valor que indica se o objeto ConfigurationElement é somente leitura. (Herdado de ConfigurationElement)
ListErrors(IList)	Adiciona os erros de propriedade inválida deste objeto ConfigurationElement e de todos os subelementos à lista passada. (Herdado de ConfigurationElement)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnDeserializeUnrecognizedAttribute(String, String)	Obtém 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)	Gera uma exceção quando uma propriedade necessária não é encontrada. (Herdado de ConfigurationElement)
PostDeserialize()	Chamado depois da desserialização. (Herdado de ConfigurationElement)
PreSerialize(XmlWriter)	Chamado antes da serialização. (Herdado de ConfigurationElement)
Reset(ConfigurationElement)	Redefine o estado interno do objeto ConfigurationElement, incluindo os bloqueios e as coleções de propriedades. (Herdado de ConfigurationElement)
ResetModified()	Redefine o valor do método IsModified() para `false` quando implementado em uma classe derivada. (Herdado de ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Grava o conteúdo desse elemento de configuração no arquivo de configuração quando implementado em uma classe derivada. (Herdado de ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Grava as marcas externas desse elemento de configuração no arquivo de configuração quando implementado em uma classe derivada. (Herdado de ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Define uma propriedade para o valor especificado. (Herdado de ConfigurationElement)
SetReadOnly()	Define a propriedade IsReadOnly() para o objeto ConfigurationElement e para todos os subelementos. (Herdado de ConfigurationElement)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modifica o objeto ConfigurationElement para remover todos os valores que não devem ser salvos. (Herdado de ConfigurationElement)

Aplica-se a