TagPrefixInfo Classe

Définition

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

Héritage

Object

ConfigurationElement

TagPrefixInfo

Exemples

Cet exemple montre comment spécifier des valeurs de façon déclarative pour plusieurs attributs de la controls section, qui sont également accessibles en tant que membres de la 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>  

L’exemple de code suivant montre comment utiliser la TagPrefixInfo classe pour modifier par programmation les paramètres de préfixe de balise. Cet exemple de code fait partie d’un exemple plus grand fourni pour la 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"))

Remarques

La TagPrefixInfo classe vous permet d’accéder et de modifier par programme les informations de préfixe de balise stockées dans un fichier de configuration. Il fournit les mêmes fonctionnalités que la directive ASP.NET @Register . Les préfixes de balise associent un « espace de noms » dans ASP.NET aux assemblys et espaces de noms qui doivent être inclus pour que les contrôles personnalisés et les contrôles utilisateur fonctionnent correctement. TagPrefixInfo les objets sont stockés en tant que membres d’un TagPrefixCollection objet . La TagPrefixCollection classe vous permet d’accéder et de modifier par programmation la controls sous-section de la pages section d’un fichier de configuration.

TagPrefixInfo Les objets sont ajoutés à la collection à l’aide de l’élément add et en spécifiant une valeur pour l’attribut tagPrefix , ainsi que des valeurs pour d’autres attributs pertinents. Les autres informations requises varient en fonction du type de contrôle que vous utiliserez avec le préfixe de balise spécifié :

• S’il s’agit d’un contrôle utilisateur, vous devez définir les TagPrefixpropriétés , TagNameet Source .

• S’il s’agit d’un contrôle personnalisé, vous devez définir les TagPrefixpropriétés , Namespaceet Assembly . La Assembly propriété n’est pas obligatoire si le contrôle se trouve dans le répertoire du code de l’application.

La même tagPrefix valeur peut être utilisée pour mapper à plusieurs assemblys ou espaces de noms.

Constructeurs

Propriétés

Méthodes

S’applique à

Voir aussi

• PagesSection
• TagPrefixCollection