AttributeCollection Classe

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.dll

Fournit un accès au modèle objet à tous les attributs déclarés dans la balise d’ouverture d’un élément de contrôle serveur ASP.NET. Cette classe ne peut pas être héritée.

public ref class AttributeCollection sealed

public sealed class AttributeCollection

type AttributeCollection = class

Public NotInheritable Class AttributeCollection

Héritage

Object

AttributeCollection

Exemples

L’exemple suivant crée un AttributeCollection objet nommé myAttributeCollection, puis vérifie si la page a été publiée. Si ce n’est pas le cas, le code ajoute deux attributs à la collection. Il obtient ensuite le nombre d’attributs de la collection et effectue une itération dans la collection, en écrivant la clé dans chaque attribut de la page. Si la page est une publication, le code obtient le nouveau nombre d’attributs et effectue une itération dans la collection, en écrivant la clé et la valeur de chaque attribut dans la page.

AttributeCollection myAttributeCollection = null;

void Page_Load(object sender,EventArgs e)
{
   myAttributeCollection = new AttributeCollection(ViewState);
   Response.Write("<h3> AttributeCollection.AttributeCollection Sample </h3>");
   if (!IsPostBack)
   {  
      myAttributeCollection.Add("Color" ,"Color.Red");
      myAttributeCollection.Add("BackColor","Color.blue");
      Response.Write("Attribute Collection  count before PostBack = " + myAttributeCollection.Count);
      Response.Write("<br /><u><h4>Enumerating Attributes for CustomControl before PostBack</h4></u>");
      IEnumerator keys = myAttributeCollection.Keys.GetEnumerator();
      int i =1;
      String key;
      while (keys.MoveNext())
      {
         key = (String)keys.Current;
         Response.Write(i + ". "+key + "=" + myAttributeCollection[key]+"<br />");
         i++;
      }
   }
   else
   {
      Response.Write("Attribute Collection  count after PostBack = "+myAttributeCollection.Count);
      Response.Write("<br /><u><h4>Enumerating Attributes for CustomControl after PostBack</h4></u>");
      IEnumerator keys = myAttributeCollection.Keys.GetEnumerator();
      int i =1;
      String key;
      while (keys.MoveNext())
      {
         key = (String)keys.Current;
         Response.Write(i + ". "+key + "=" + myAttributeCollection[key]+"<br />");
         i++;
      }
   }
}

  Dim myAttributeCollection As AttributeCollection = Nothing 

  Sub Page_Load(sender As Object, e As EventArgs)
      myAttributeCollection = New AttributeCollection(ViewState)
      Response.Write("<h3> AttributeCollection.AttributeCollection Sample </h3>")
      If Not IsPostBack Then
         myAttributeCollection.Add("Color", "Color.Red")
         myAttributeCollection.Add("BackColor", "Color.blue")
         Response.Write("Attribute Collection count before PostBack = " & _
myAttributeCollection.Count.ToString())
         Response.Write("<br /><u><h4>Enumerating Attributes for " & _
                                 "CustomControl before PostBack</h4></u>")
         Dim keys As IEnumerator = myAttributeCollection.Keys.GetEnumerator()
         Dim i As Integer = 1
         Dim key As String
         While keys.MoveNext()
            key = CType(keys.Current, String)
            Response.Write(i.ToString() + ". " + key + "=" + myAttributeCollection(key) + "<br />")
            i += 1
         End While
      Else
         Response.Write("Attribute Collection  count after PostBack = " + _
                                    myAttributeCollection.Count.ToString())
         Response.Write("<br /><u><h4>Enumerating Attributes for " + _
                                 "CustomControl after PostBack</h4></u>")
         Dim keys As IEnumerator = myAttributeCollection.Keys.GetEnumerator()
         Dim i As Integer = 1
         Dim key As String
         While keys.MoveNext()
            key = CType(keys.Current, String)
            Response.Write(i.ToString() + ". " + key + "=" + myAttributeCollection(key) + "<br />")
            i += 1
         End While
      End If
   End Sub

Remarques

Les éléments individuels de la collection retournent un String objet comme valeur. S’il n’existe aucun élément d’attribut dans la collection, la collection retourne null.

Les attributs d’un contrôle serveur HTML sont disponibles par programmation via la Attributes propriété, qui est héritée par tous les contrôles serveur HTML. ASP.NET expose les attributs des contrôles serveur HTML en tant que propriétés de ces contrôles.

Vous pouvez ajouter des attributs à un contrôle de serveur Web via la Attributes propriété, qui est héritée par tous les contrôles de serveur Web. Les attributs de la collection d’attributs d’un contrôle serveur Web ne correspondent pas nécessairement aux propriétés fortement typées du contrôle pour ce contrôle.

Constructeurs

Nom	Description
AttributeCollection(StateBag)	Initialise une nouvelle instance de la classe AttributeCollection.

Propriétés

Nom	Description
Count	Obtient le nombre d’attributs dans l’objet AttributeCollection .
CssStyle	Obtient une collection de styles pour le contrôle serveur ASP.NET auquel appartient l’objet actuel AttributeCollection .
Item[String]	Obtient ou définit une valeur d’attribut spécifiée pour un contrôle serveur.
Keys	Obtient une collection de clés pour tous les attributs de l’objet du AttributeCollection contrôle serveur.

Méthodes

Nom	Description
Add(String, String)	Ajoute un attribut à l’objet d’un contrôle serveur AttributeCollection .
AddAttributes(HtmlTextWriter)	Ajoute des attributs de la AttributeCollection classe à l’objet responsable du HtmlTextWriter rendu des attributs en tant que balisage.
Clear()	Supprime tous les attributs de l’objet d’un contrôle serveur AttributeCollection .
Equals(Object)	Détermine si l’instance actuelle de l’objet AttributeCollection est égale à l’objet spécifié.
GetHashCode()	Retourne le code de hachage pour cette instance.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
Remove(String)	Supprime un attribut de l’objet d’un contrôle serveur AttributeCollection .
Render(HtmlTextWriter)	Écrit la collection d’attributs dans le flux de sortie spécifié HtmlTextWriter pour le contrôle auquel appartient la collection.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• Attributes
• Attributes