AttributeCollection Clase

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.dll

Proporciona acceso de modelo de objetos a todos los atributos declarados en la etiqueta de apertura de un elemento de control de servidor ASP.NET. Esta clase no puede heredarse.

public ref class AttributeCollection sealed

public sealed class AttributeCollection

type AttributeCollection = class

Public NotInheritable Class AttributeCollection

Herencia

Object

AttributeCollection

Ejemplos

En el ejemplo siguiente se crea un nuevo AttributeCollection objeto denominado myAttributeCollectiony, a continuación, se comprueba si la página se ha publicado de nuevo. Si no lo tiene, el código agrega dos atributos a la colección. A continuación, obtiene el número de atributos de la colección y recorre en iteración la colección, escribiendo la clave en cada atributo de la página. Si la página es un postback, el código obtiene el nuevo número de atributos y recorre en iteración la colección, escribiendo la clave y el valor de cada atributo en la página.

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

Comentarios

Los elementos individuales de la colección devuelven un String objeto como su valor. Si no hay ningún elemento de atributo en la colección, la colección devuelve null.

Los atributos de un control de servidor HTML están disponibles mediante programación a través de la Attributes propiedad , que todos los controles de servidor HTML heredan. ASP.NET expone atributos de controles de servidor HTML como propiedades de esos controles.

Puede agregar atributos a un control de servidor web a través de la Attributes propiedad , que heredan todos los controles de servidor web. Los atributos de la colección attributes de un control de servidor web no corresponden necesariamente a las propiedades fuertemente tipadas del control para ese control.

Constructores

AttributeCollection(StateBag)

Inicializa una nueva instancia de la clase AttributeCollection.

Propiedades

Count	Obtiene el número de atributos del objeto AttributeCollection.
CssStyle	Obtiene una colección de estilos para el control de servidor ASP.NET al que pertenece el objeto AttributeCollection actual.
Item[String]	Obtiene o establece un valor de atributo especificado para un control de servidor.
Keys	Obtiene una colección de claves para todos los atributos del objeto AttributeCollection del control de servidor.

Métodos

Add(String, String)	Agrega un atributo al objeto AttributeCollection de un control de servidor.
AddAttributes(HtmlTextWriter)	Agrega atributos de la clase AttributeCollection al objeto HtmlTextWriter que es responsable de representar los atributos como marcado.
Clear()	Quita todos los atributos del objeto AttributeCollection de un control de servidor.
Equals(Object)	Determina si la instancia actual del objeto AttributeCollection es igual al objeto especificado.
GetHashCode()	Devuelve el código hash de esta instancia.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Remove(String)	Quita un atributo del objeto AttributeCollection de un control de servidor.
Render(HtmlTextWriter)	Escribe la colección de atributos en el flujo de salida de HtmlTextWriter especificada para el control al que pertenece la colección.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• Attributes
• Attributes