TagPrefixInfo Classe

Définition

Espace de noms:

System.Web.Configuration

Assembly:

System.Web.dll

Définit un élément de configuration contenant des informations relatives aux balises.

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 manière 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 d’étiquette. 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 par programmation et de modifier 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 par programmation et de modifier la controls sous-section d’un pages 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 allez utiliser avec le préfixe de balise spécifié :

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

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

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

Note

Lorsqu’une source est spécifiée, le contrôle utilisateur lui-même ne doit pas se trouver dans le même répertoire que la page. Si c’est le cas, vous obtenez une erreur d’exécution lorsque vous tentez de charger la page.

Constructeurs

Nom	Description
TagPrefixInfo(String, String, String, String, String)	Initialise une nouvelle instance de la classe à l’aide TagPrefixInfo des valeurs passées.

Propriétés

Nom	Description
Assembly	Obtient ou définit le nom de l’assembly contenant l’implémentation du contrôle.
CurrentConfiguration	Obtient une référence à l’instance de niveau Configuration supérieur qui représente la hiérarchie de configuration à laquelle appartient l’instance actuelle ConfigurationElement . (Hérité de ConfigurationElement)
ElementInformation	Obtient un ElementInformation objet qui contient les informations et fonctionnalités non personnalisables de l’objet ConfigurationElement . (Hérité de ConfigurationElement)
ElementProperty	Obtient l’objet ConfigurationElementProperty qui représente l’objet ConfigurationElement lui-même. (Hérité de ConfigurationElement)
EvaluationContext	Obtient l'objet ContextInformation pour l'objet ConfigurationElement. (Hérité de ConfigurationElement)
HasContext	Obtient une valeur qui indique si la CurrentConfiguration propriété est null. (Hérité de ConfigurationElement)
Item[ConfigurationProperty]	Obtient ou définit une propriété ou un attribut de cet élément de configuration. (Hérité de ConfigurationElement)
Item[String]	Obtient ou définit une propriété, un attribut ou un élément enfant de cet élément de configuration. (Hérité de ConfigurationElement)
LockAllAttributesExcept	Obtient la collection d’attributs verrouillés. (Hérité de ConfigurationElement)
LockAllElementsExcept	Obtient la collection d’éléments verrouillés. (Hérité de ConfigurationElement)
LockAttributes	Obtient la collection d’attributs verrouillés. (Hérité de ConfigurationElement)
LockElements	Obtient la collection d’éléments verrouillés. (Hérité de ConfigurationElement)
LockItem	Obtient ou définit une valeur indiquant si l’élément est verrouillé. (Hérité de ConfigurationElement)
Namespace	Obtient ou définit l’espace de noms dans lequel réside le contrôle.
Properties	Obtient la collection de propriétés. (Hérité de ConfigurationElement)
Source	Obtient ou définit le nom et le chemin d’accès du fichier contenant le contrôle utilisateur.
TagName	Obtient ou définit le nom du contrôle utilisateur.
TagPrefix	Obtient ou définit le préfixe d’étiquette associé à un fichier source ou un espace de noms et un assembly.

Méthodes

Nom	Description
DeserializeElement(XmlReader, Boolean)	Lit le code XML à partir du fichier de configuration. (Hérité de ConfigurationElement)
Equals(Object)	Compare cette instance à un autre objet.
GetHashCode()	Retourne une valeur de hachage pour l’instance actuelle.
GetTransformedAssemblyString(String)	Retourne la version transformée du nom d’assembly spécifié. (Hérité de ConfigurationElement)
GetTransformedTypeString(String)	Retourne la version transformée du nom de type spécifié. (Hérité de ConfigurationElement)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
Init()	Définit l’objet ConfigurationElement à son état initial. (Hérité de ConfigurationElement)
InitializeDefault()	Permet d’initialiser un jeu de valeurs par défaut pour l’objet ConfigurationElement . (Hérité de ConfigurationElement)
IsModified()	Indique si cet élément de configuration a été modifié depuis son dernier enregistrement ou chargement, lorsqu’il est implémenté dans une classe dérivée. (Hérité de ConfigurationElement)
IsReadOnly()	Obtient une valeur indiquant si l’objet ConfigurationElement est en lecture seule. (Hérité de ConfigurationElement)
ListErrors(IList)	Ajoute les erreurs de propriété non valides dans cet ConfigurationElement objet et, dans tous les sous-éléments, à la liste passée. (Hérité de ConfigurationElement)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnDeserializeUnrecognizedAttribute(String, String)	Obtient une valeur indiquant si un attribut inconnu est rencontré lors de la désérialisation. (Hérité de ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Obtient une valeur indiquant si un élément inconnu est rencontré lors de la désérialisation. (Hérité de ConfigurationElement)
OnRequiredPropertyNotFound(String)	Lève une exception lorsqu’une propriété requise est introuvable. (Hérité de ConfigurationElement)
PostDeserialize()	Appelé après la désérialisation. (Hérité de ConfigurationElement)
PreSerialize(XmlWriter)	Appelé avant la sérialisation. (Hérité de ConfigurationElement)
Reset(ConfigurationElement)	Réinitialise l’état interne de l’objet ConfigurationElement , y compris les verrous et les collections de propriétés. (Hérité de ConfigurationElement)
ResetModified()	Réinitialise la valeur de la IsModified() méthode false lorsqu’elle est implémentée dans une classe dérivée. (Hérité de ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Écrit le contenu de cet élément de configuration dans le fichier de configuration en cas d’implémentation dans une classe dérivée. (Hérité de ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Écrit les balises externes de cet élément de configuration dans le fichier de configuration en cas d’implémentation dans une classe dérivée. (Hérité de ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Définit une propriété sur la valeur spécifiée. (Hérité de ConfigurationElement)
SetReadOnly()	Définit la IsReadOnly() propriété de l’objet ConfigurationElement et de tous les sous-éléments. (Hérité de ConfigurationElement)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modifie l’objet ConfigurationElement pour supprimer toutes les valeurs qui ne doivent pas être enregistrées. (Hérité de ConfigurationElement)

Voir aussi

• PagesSection
• TagPrefixCollection