TagPrefixCollection 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 TagPrefixInfo .

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

[System.Configuration.ConfigurationCollection(typeof(System.Web.Configuration.TagPrefixInfo), AddItemName="add", CollectionType=System.Configuration.ConfigurationElementCollectionType.BasicMap)]
public sealed class TagPrefixCollection : System.Configuration.ConfigurationElementCollection

[<System.Configuration.ConfigurationCollection(typeof(System.Web.Configuration.TagPrefixInfo), AddItemName="add", CollectionType=System.Configuration.ConfigurationElementCollectionType.BasicMap)>]
type TagPrefixCollection = class
    inherit ConfigurationElementCollection

Public NotInheritable Class TagPrefixCollection
Inherits ConfigurationElementCollection

Herança: Object

ConfigurationElement

ConfigurationElementCollection
TagPrefixCollection

Atributos: ConfigurationCollectionAttribute

Exemplos

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

<system.web>  
  <pages>  
    <controls>  
      <clear />  
      <remove tagPrefix="MyTags" />  
      <!-- Searches all linked assemblies for the namespace -->  
      <add tagPrefix="MyTags1" namespace=" MyNameSpace "/>  
      <!-- Uses a specified assembly -->  
      <add tagPrefix="MyTags2" namespace="MyNameSpace"   
        assembly="MyAssembly"/>  
      <!-- Uses the specified source for the user control -->  
      <add tagprefix="MyTags3" tagname="MyCtrl" src="MyControl.ascx"/>  
    </controls>  
   </pages>  
</system.web>

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

// Get all current Controls in the collection.
for (int i = 0; i < pagesSection.Controls.Count; i++)
{
  Console.WriteLine("Control {0}:", i);
  Console.WriteLine("  TagPrefix = '{0}' ",
      pagesSection.Controls[i].TagPrefix);
  Console.WriteLine("  TagName = '{0}' ",
      pagesSection.Controls[i].TagName);
  Console.WriteLine("  Source = '{0}' ",
      pagesSection.Controls[i].Source);
  Console.WriteLine("  Namespace = '{0}' ",
      pagesSection.Controls[i].Namespace);
  Console.WriteLine("  Assembly = '{0}' ",
      pagesSection.Controls[i].Assembly);
}

// Create a new TagPrefixInfo object.
System.Web.Configuration.TagPrefixInfo tagPrefixInfo =
    new System.Web.Configuration.TagPrefixInfo("MyCtrl", "MyNameSpace", "MyAssembly", "MyControl", "MyControl.ascx");

// Execute the Add Method.
pagesSection.Controls.Add(tagPrefixInfo);

// Add a TagPrefixInfo object using a constructor.
pagesSection.Controls.Add(
    new System.Web.Configuration.TagPrefixInfo(
    "MyCtrl", "MyNameSpace", "MyAssembly", "MyControl",
    "MyControl.ascx"));

' Get all current Controls in the collection.
Dim j As Int32
For j = 0 To pagesSection.Controls.Count - 1
  Console.WriteLine("Control {0}:", j)
  Console.WriteLine("  TagPrefix = '{0}' ", _
   pagesSection.Controls(j).TagPrefix)
  Console.WriteLine("  TagName = '{0}' ", _
   pagesSection.Controls(j).TagName)
  Console.WriteLine("  Source = '{0}' ", _
   pagesSection.Controls(j).Source)
  Console.WriteLine("  Namespace = '{0}' ", _
   pagesSection.Controls(j).Namespace)
  Console.WriteLine("  Assembly = '{0}' ", _
   pagesSection.Controls(j).Assembly)
Next

' Create a new TagPrefixInfo object.
Dim tagPrefixInfo As System.Web.Configuration.TagPrefixInfo = _
 New System.Web.Configuration.TagPrefixInfo("MyCtrl", "MyNameSpace", "MyAssembly", "MyControl", "MyControl.ascx")

' Execute the Add Method.
pagesSection.Controls.Add(tagPrefixInfo)

' Add a TagPrefixInfo object using a constructor.
pagesSection.Controls.Add( _
 New System.Web.Configuration.TagPrefixInfo( _
 "MyCtrl", "MyNameSpace", "MyAssembly", "MyControl", _
 "MyControl.ascx"))

Comentários

A TagPrefixInfo classe permite que você acesse e modifique programaticamente as informações de prefixo de marca armazenadas em um arquivo de configuração. Os prefixos de marca associam um "namespace" em ASP.NET com os assemblies e namespaces que devem ser incluídos para controles personalizados e controles de usuário funcionarem corretamente.

TagPrefixInfo os objetos são armazenados como membros de um TagPrefixCollection objeto. A TagPrefixCollection classe permite que você acesse e modifique programaticamente a controls subseção da pages seção de um arquivo de configuração.

Construtores

TagPrefixCollection()

Cria uma nova instância da classe TagPrefixCollection.

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 da coleção de configuração.
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 TagPrefixInfo 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(TagPrefixInfo)	Adiciona um objeto de TagPrefixInfo à 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(TagPrefixInfo)	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