TagMapCollection 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 coleção de objetos TagMapInfo .

public ref class TagMapCollection sealed : System::Configuration::ConfigurationElementCollection

[System.Configuration.ConfigurationCollection(typeof(System.Web.Configuration.TagMapInfo))]
public sealed class TagMapCollection : System.Configuration.ConfigurationElementCollection

[<System.Configuration.ConfigurationCollection(typeof(System.Web.Configuration.TagMapInfo))>]
type TagMapCollection = class
    inherit ConfigurationElementCollection

Public NotInheritable Class TagMapCollection
Inherits ConfigurationElementCollection

Herança: Object

ConfigurationElement

ConfigurationElementCollection
TagMapCollection

Atributos: ConfigurationCollectionAttribute

Exemplos

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

<system.web>  
  <pages>  
    <tagMapping>  
      <clear />  
      <add  
        tagType=  
          "System.Web.UI.WebControls.WebParts.WebPartManager"  
        mappedTagType=  
          "Microsoft.Sharepoint.WebPartPartManager,   
           MSPS.Web.dll, Version='2.0.0.0'"   
      />  
      <remove tagType="SomeOtherNS.Class, Assemblyname" />  
    </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 remapeamento 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. tagMapping 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 marcas não tem nenhuma diretiva de página de ASP.NET correspondente.

Construtores

TagMapCollection()

Inicializa uma nova instância da classe TagMapCollection.

Propriedades

AddElementName	Obtém ou define o nome do ConfigurationElement a ser associado à operação de adição no ConfigurationElementCollection quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
ClearElementName	Obtém ou define o nome do ConfigurationElement a ser associado à operação de limpeza no ConfigurationElementCollection quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
CollectionType	Obtém o tipo do ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
Count	Obtém o número de elementos na coleção. (Herdado de ConfigurationElementCollection)
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)
ElementName	Obtém o nome usado para identificar esta coleção de elementos no arquivo de configuração quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
ElementProperty	Obtém o objeto ConfigurationElementProperty que representa o próprio objeto ConfigurationElement. (Herdado de ConfigurationElement)
EmitClear	Obtém ou define um valor que especifica se a coleção foi limpa. (Herdado de ConfigurationElementCollection)
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)
IsSynchronized	Obtém um valor que indica se o acesso à coleção é sincronizado. (Herdado de ConfigurationElementCollection)
Item[ConfigurationProperty]	Obtém ou define uma propriedade ou um atributo desse elemento de configuração. (Herdado de ConfigurationElement)
Item[Int32]	Obtém ou define o objeto TagMapInfo no local do índice especificado.
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)
Properties	Obtém a coleção de propriedades. (Herdado de ConfigurationElement)
RemoveElementName	Obtém ou define o nome do ConfigurationElement a ser associado à operação de remoção no ConfigurationElementCollection quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
SyncRoot	Obtém um objeto usado para sincronizar o acesso ao ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
ThrowOnDuplicate	Obtém um valor que indica se uma tentativa de adicionar uma duplicata ConfigurationElement ao ConfigurationElementCollection fará com que uma exceção seja lançada. (Herdado de ConfigurationElementCollection)

Métodos

Add(TagMapInfo)	Adiciona um objeto de TagMapInfo à coleção.
BaseAdd(ConfigurationElement)	Adiciona um elemento de configuração ao ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
BaseAdd(ConfigurationElement, Boolean)	Adiciona um elemento de configuração à coleção de elementos de configuração. (Herdado de ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)	Adiciona um elemento de configuração à coleção de elementos de configuração. (Herdado de ConfigurationElementCollection)
BaseClear()	Remove todos os objetos de elemento de configuração da coleção. (Herdado de ConfigurationElementCollection)
BaseGet(Int32)	Obtém o elemento de configuração no local do índice especificado. (Herdado de ConfigurationElementCollection)
BaseGet(Object)	Retorna o elemento de configuração com a chave especificada. (Herdado de ConfigurationElementCollection)
BaseGetAllKeys()	Retorna uma matriz das chaves para todos os elementos de configuração contidos no ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
BaseGetKey(Int32)	Obtém a chave para o ConfigurationElement no local do índice especificado. (Herdado de ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)	Indica o índice do ConfigurationElement especificado. (Herdado de ConfigurationElementCollection)
BaseIsRemoved(Object)	Indica se o ConfigurationElement com a chave especificada foi removido do ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
BaseRemove(Object)	Remove um ConfigurationElement da coleção. (Herdado de ConfigurationElementCollection)
BaseRemoveAt(Int32)	Remove o ConfigurationElement no local de índice especificado. (Herdado de ConfigurationElementCollection)
Clear()	Limpa todos os objetos da coleção.
CopyTo(ConfigurationElement[], Int32)	Copia o conteúdo do ConfigurationElementCollection para uma matriz. (Herdado de ConfigurationElementCollection)
CreateNewElement()	Quando substituído em uma classe derivada, cria um novo ConfigurationElement. (Herdado de ConfigurationElementCollection)
CreateNewElement(String)	Cria um novo ConfigurationElement quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)	Lê o XML do arquivo de configuração. (Herdado de ConfigurationElement)
Equals(Object)	Compara o ConfigurationElementCollection ao objeto especificado. (Herdado de ConfigurationElementCollection)
GetElementKey(ConfigurationElement)	Obtém a chave de elemento para um elemento de configuração especificado quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
GetEnumerator()	Obtém um IEnumerator que é usado para iterar por meio de ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
GetHashCode()	Obtém um valor exclusivo que representa a instância ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
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)
IsElementName(String)	Indica se o ConfigurationElement especificado existe no ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)	Indica se o ConfigurationElement especificado pode ser removido de ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
IsModified()	Indica se este ConfigurationElementCollection foi modificado desde a última vez em que foi salvo ou carregado quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
IsReadOnly()	Indica se o objeto ConfigurationElementCollection é somente leitura. (Herdado de ConfigurationElementCollection)
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)	Faz com que o sistema de configuração lance uma exceção. (Herdado de ConfigurationElementCollection)
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)
Remove(TagMapInfo)	Remove o objeto especificado da coleção.
Reset(ConfigurationElement)	Redefine o ConfigurationElementCollection para seu estado inalterado quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
ResetModified()	Redefine o valor da propriedade IsModified() para `false` quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)	Grava os dados de configuração em um elemento XML no arquivo de configuração quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection)
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 ConfigurationElementCollection e para todos os subelementos. (Herdado de ConfigurationElementCollection)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Inverte o efeito da mesclagem de informações de configuração de diferentes níveis da hierarquia de configuração. (Herdado de ConfigurationElementCollection)

Implantações explícitas de interface

ICollection.CopyTo(Array, Int32)

Copia o ConfigurationElementCollection para uma matriz.

(Herdado de ConfigurationElementCollection)

Métodos de Extensão

Cast<TResult>(IEnumerable)	Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base em um tipo especificado.
AsParallel(IEnumerable)	Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable em um IQueryable.

Aplica-se a

Compartilhar via