TagPrefixCollection Classe
Definição
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 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
- Atributos
Exemplos
O trecho do arquivo de configuração a seguir mostra como especificar valores declarativamente 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 que controles personalizados e controles de usuário funcionem 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
| Nome | Description |
|---|---|
| TagPrefixCollection() |
Cria uma nova instância da TagPrefixCollection classe. |
Propriedades
| Nome | Description |
|---|---|
| AddElementName |
Obtém ou define o nome do ConfigurationElement a ser associado à operação de adição ConfigurationElementCollection no quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection) |
| ClearElementName |
Obtém ou define o nome para associar ConfigurationElement à operação clear 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 à instância de nível Configuration superior que representa a hierarquia de configuração à qual a instância atual ConfigurationElement pertence. (Herdado de ConfigurationElement) |
| ElementInformation |
Obtém um ElementInformation objeto que contém as informações e funcionalidades não personalizáveis do ConfigurationElement objeto. (Herdado de ConfigurationElement) |
| ElementName |
Obtém o nome usado para identificar essa coleção de elementos no arquivo de configuração quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection) |
| ElementProperty |
Obtém o ConfigurationElementProperty objeto que representa o ConfigurationElement objeto em si. (Herdado de ConfigurationElement) |
| EmitClear |
Obtém ou define um valor que especifica se a coleção foi desmarcada. (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 CurrentConfiguration propriedade é |
| 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 atributo desse elemento de configuração. (Herdado de ConfigurationElement) |
| Item[Int32] |
Obtém ou define o TagPrefixInfo objeto no local do índice especificado. |
| Item[String] |
Obtém ou define uma propriedade, um atributo ou um 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 associado à operação de remoção no momento em ConfigurationElementCollection que substituído em uma classe derivada. (Herdado de ConfigurationElementCollection) |
| SyncRoot |
Obtém um objeto usado para sincronizar o ConfigurationElementCollectionacesso ao . (Herdado de ConfigurationElementCollection) |
| ThrowOnDuplicate |
Obtém um valor que indica se uma tentativa de adicionar uma duplicata ConfigurationElement à ConfigurationElementCollection causará a geração de uma exceção. (Herdado de ConfigurationElementCollection) |
Métodos
| Nome | 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 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 local do índice especificado. (Herdado de ConfigurationElementCollection) |
| BaseIndexOf(ConfigurationElement) |
Indica o índice do especificado ConfigurationElement. (Herdado de ConfigurationElementCollection) |
| BaseIsRemoved(Object) |
Indica se a ConfigurationElement chave com a especificada foi removida do ConfigurationElementCollection. (Herdado de ConfigurationElementCollection) |
| BaseRemove(Object) |
Remove um ConfigurationElement da coleção. (Herdado de ConfigurationElementCollection) |
| BaseRemoveAt(Int32) |
Remove o ConfigurationElement local do índice especificado. (Herdado de ConfigurationElementCollection) |
| Clear() |
Limpa todo o objeto da coleção. |
| CopyTo(ConfigurationElement[], Int32) |
Copia o conteúdo da ConfigurationElementCollection matriz 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ê XML do arquivo de configuração. (Herdado de ConfigurationElement) |
| Equals(Object) |
Compara o ConfigurationElementCollection 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 do ConfigurationElementCollection. (Herdado de ConfigurationElementCollection) |
| GetHashCode() |
Obtém um valor exclusivo que representa a ConfigurationElementCollection instância. (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 de tipo especificado. (Herdado de ConfigurationElement) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| Init() |
Define o ConfigurationElement objeto como 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 isso ConfigurationElementCollection foi modificado desde que foi salvo ou carregado pela última vez quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection) |
| IsReadOnly() |
Indica se o ConfigurationElementCollection objeto é somente leitura. (Herdado de ConfigurationElementCollection) |
| ListErrors(IList) |
Adiciona os erros de propriedade inválido nesse ConfigurationElement objeto e, em todos os subelementos, à lista passada. (Herdado de ConfigurationElement) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (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 gere 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 após a 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 estado não modificado quando substituído em uma classe derivada. (Herdado de ConfigurationElementCollection) |
| ResetModified() |
Redefine o valor da IsModified() propriedade para |
| 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 como o valor especificado. (Herdado de ConfigurationElement) |
| SetReadOnly() |
Define a IsReadOnly() propriedade para o ConfigurationElementCollection objeto e para todos os sub-elementos. (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
| Nome | Description |
|---|---|
| ICollection.CopyTo(Array, Int32) |
Copia para ConfigurationElementCollection uma matriz. (Herdado de ConfigurationElementCollection) |
Métodos de Extensão
| Nome | Description |
|---|---|
| AsParallel(IEnumerable) |
Habilita a paralelização de uma consulta. |
| AsQueryable(IEnumerable) |
Converte um IEnumerable em um IQueryable. |
| 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. |