TagPrefixInfo Classe

Definição

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

public sealed class TagPrefixInfo : System.Configuration.ConfigurationElement

type TagPrefixInfo = class
    inherit ConfigurationElement

Public NotInheritable Class TagPrefixInfo
Inherits ConfigurationElement

Herança

Object

ConfigurationElement

TagPrefixInfo

Exemplos

Este exemplo demonstra como especificar valores declarativamente para vários atributos da controls seção, que também podem ser acessados como membros da TagPrefixInfo classe.

<system.web>  
  <pages>  
    <controls>  
      <!-- 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 TagPrefixInfo 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. Ele fornece a mesma funcionalidade que a diretiva ASP.NET@Register. Os prefixos de marca associam um "namespace" em ASP.NET aos 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.

TagPrefixInfo os objetos são adicionados à coleção usando o add elemento e especificando um valor para o tagPrefix atributo junto com valores para outros atributos relevantes. As outras informações necessárias variam de acordo com o tipo de controle que você usará com o prefixo de marca especificado:

• Se for um controle de usuário, você deverá definir as propriedades e Source as TagPrefixTagNamepropriedades.

• Se for um controle personalizado, você deverá definir as propriedades e Assembly as TagPrefixNamespacepropriedades. A Assembly propriedade não será necessária se o controle estiver no diretório de código do aplicativo.

O mesmo tagPrefix valor pode ser usado para mapear para vários assemblies ou namespaces.

Construtores

Propriedades

Métodos

Aplica-se a

Confira também

• PagesSection
• TagPrefixCollection