AttributeCollection Classe

Référence

Définition

Espace de noms:: System.Web.UI

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Fournit au modèle objet l'accès à 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é réédée. Si ce n’est pas le cas, le code ajoute deux attributs à la collection. Il obtient ensuite le nombre d’attributs dans la collection et effectue une itération au sein de la collection, en écrivant la clé de chaque attribut dans 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’y a aucun élément d’attribut dans la collection, la collection retourne null.

Les attributs sur 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 serveur Web via la Attributes propriété , qui est héritée par tous les contrôles 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

AttributeCollection(StateBag)

Initialise une nouvelle instance de la classe AttributeCollection.

Propriétés

Count	Obtient le nombre d'attributs dans AttributeCollection.
CssStyle	Obtient une collection de styles pour le contrôle serveur ASP.NET auquel l'objet AttributeCollection en cours appartient.
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 d'accès à tous les attributs contenus dans l'objet AttributeCollection du contrôle serveur.

Méthodes

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

S’applique à