TagPrefixCollection Classe

Definição

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

Assemblagem:: System.Web.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.

Contém uma coleção de TagPrefixInfo objetos.

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 excerto seguinte do ficheiro de configuração 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 seguinte exemplo de código mostra como usar a TagPrefixCollection classe para modificar programaticamente as definições do prefixo de etiquetas. 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"))

Observações

A TagPrefixInfo classe permite-lhe aceder programaticamente e modificar informações de prefixo de etiquetas armazenadas num ficheiro de configuração. Os prefixos de etiquetas associam um "namespace" no ASP.NET aos assemblies e namespaces que devem ser incluídos para que os controlos personalizados e os controlos de utilizador funcionem corretamente.

TagPrefixInfo Os objetos são armazenados como membros de um TagPrefixCollection objeto. A TagPrefixCollection classe permite-lhe aceder e modificar programaticamente a controls subseção da pages secção de um ficheiro de configuração.

Construtores

Name	Description
TagPrefixCollection()	Cria uma nova instância da TagPrefixCollection classe.

Propriedades

Name	Description
AddElementName	Obtém ou define o nome do ConfigurationElement para associar à operação de adição em quando ConfigurationElementCollection são sobrepostos numa classe derivada. (Herdado de ConfigurationElementCollection)
ClearElementName	Obtém ou define o nome para o ConfigurationElement associar à operação clear em quando ConfigurationElementCollection são sobrepostos numa classe derivada. (Herdado de ConfigurationElementCollection)
CollectionType	Obtém o tipo da coleção de configurações.
Count	Obtém o número de elementos na coleção. (Herdado de ConfigurationElementCollection)
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)
ElementName	Recebe o nome usado para identificar esta coleção de elementos no ficheiro de configuração quando sobreposta numa classe derivada. (Herdado de ConfigurationElementCollection)
ElementProperty	Obtém o ConfigurationElementProperty objeto que representa o ConfigurationElement próprio objeto. (Herdado de ConfigurationElement)
EmitClear	Recebe ou define um valor que especifica se a coleção foi limpa. (Herdado de ConfigurationElementCollection)
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)
IsSynchronized	Recebe um valor que indica se o acesso à coleção está sincronizado. (Herdado de ConfigurationElementCollection)
Item[ConfigurationProperty]	Obtém ou define uma propriedade ou atributo deste elemento de configuração. (Herdado de ConfigurationElement)
Item[Int32]	Obtém ou define o TagPrefixInfo objeto na localização do índice especificada.
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)
Properties	Recebe a coleção de propriedades. (Herdado de ConfigurationElement)
RemoveElementName	Obtém ou define o nome do ConfigurationElement para associar à operação de remoção em quando ConfigurationElementCollection sobrescrito numa 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 um duplicado ConfigurationElement a ConfigurationElementCollection fará com que seja lançada uma exceção. (Herdado de ConfigurationElementCollection)

Métodos

Name	Description
Add(TagPrefixInfo)	Adiciona um TagPrefixInfo objeto à coleção.
BaseAdd(ConfigurationElement, Boolean)	Adiciona um elemento de configuração à coleção de elementos de configuração. (Herdado de ConfigurationElementCollection)
BaseAdd(ConfigurationElement)	Adiciona um elemento de configuração ao ConfigurationElementCollection. (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 elemento de configuração da coleção. (Herdado de ConfigurationElementCollection)
BaseGet(Int32)	Obtém o elemento de configuração na localização do índice especificada. (Herdado de ConfigurationElementCollection)
BaseGet(Object)	Devolve o elemento de configuração com a chave especificada. (Herdado de ConfigurationElementCollection)
BaseGetAllKeys()	Devolve um array das chaves para todos os elementos de configuração contidos no ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
BaseGetKey(Int32)	Obtém a chave para o ConfigurationElement na localização do índice especificada. (Herdado de ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)	Indica o índice do especificado ConfigurationElement. (Herdado de ConfigurationElementCollection)
BaseIsRemoved(Object)	Indica se o ConfigurationElement com a chave especificada foi removido do ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
BaseRemove(Object)	Remove a ConfigurationElement da coleção. (Herdado de ConfigurationElementCollection)
BaseRemoveAt(Int32)	Remove o ConfigurationElement na localização do índice especificada. (Herdado de ConfigurationElementCollection)
Clear()	Limpa todos os objetos da coleção.
CopyTo(ConfigurationElement[], Int32)	Copia o conteúdo do ConfigurationElementCollection para um array. (Herdado de ConfigurationElementCollection)
CreateNewElement()	Quando sobreposto numa classe derivada, cria-se um novo ConfigurationElement. (Herdado de ConfigurationElementCollection)
CreateNewElement(String)	Cria um novo ConfigurationElement quando é sobreposto numa classe derivada. (Herdado de ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)	Lê XML a partir do ficheiro de configuração. (Herdado de ConfigurationElement)
Equals(Object)	Compara o ConfigurationElementCollection com o objeto especificado. (Herdado de ConfigurationElementCollection)
GetElementKey(ConfigurationElement)	Obtém a chave de elemento para um elemento de configuração especificado quando sobrescrito numa classe derivada. (Herdado de ConfigurationElementCollection)
GetEnumerator()	Obtém um IEnumerator que é usado para iterar através do ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
GetHashCode()	Obtém um valor único que representa a ConfigurationElementCollection instância. (Herdado de ConfigurationElementCollection)
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)
IsElementName(String)	Indica se o especificado ConfigurationElement existe no ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)	Indica se o especificado ConfigurationElement pode ser removido do ConfigurationElementCollection. (Herdado de ConfigurationElementCollection)
IsModified()	Indica se isto ConfigurationElementCollection foi modificado desde a última vez que foi guardado ou carregado quando sobrescrito numa classe derivada. (Herdado de ConfigurationElementCollection)
IsReadOnly()	Indica se o ConfigurationElementCollection objeto é apenas leitura. (Herdado de ConfigurationElementCollection)
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)	Faz com que o sistema de configuração lance uma exceção. (Herdado de ConfigurationElementCollection)
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)
Remove(TagPrefixInfo)	Remove o objeto especificado da coleção.
Reset(ConfigurationElement)	Reinicia o ConfigurationElementCollection para o seu estado não modificado quando sobreposto numa classe derivada. (Herdado de ConfigurationElementCollection)
ResetModified()	Redefine o valor da IsModified() propriedade para `false` quando é sobrescrito numa classe derivada. (Herdado de ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)	Escreve os dados de configuração num elemento XML no ficheiro de configuração quando sobreposto numa classe derivada. (Herdado de ConfigurationElementCollection)
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 ConfigurationElementCollection objeto e para todos os subelementos. (Herdado de ConfigurationElementCollection)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Inverte o efeito da fusão de informação de configuração de diferentes níveis da hierarquia de configuração. (Herdado de ConfigurationElementCollection)

Implementações de Interface Explícita

Name	Description
ICollection.CopyTo(Array, Int32)	Copia para ConfigurationElementCollection um array. (Herdado de ConfigurationElementCollection)

Métodos da Extensão

Name	Description
AsParallel(IEnumerable)	Permite a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable para um IQueryable.
Cast<TResult>(IEnumerable)	Conjura os elementos de an IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base num tipo especificado.

Aplica-se a

Ver também

Comentários

Esta página foi útil?