AttributeCollection Classe

Definição

public ref class AttributeCollection sealed

public sealed class AttributeCollection

type AttributeCollection = class

Public NotInheritable Class AttributeCollection

Herança

Object

AttributeCollection

Exemplos

O exemplo a seguir cria um novo AttributeCollection objeto nomeado myAttributeCollectione verifica se a página foi postada novamente. Se não tiver, o código adicionará dois atributos à coleção. Em seguida, ele obtém o número de atributos na coleção e itera por meio da coleção, gravando a chave em cada atributo na página. Se a página for um postback, o código obterá o novo número de atributos e itera pela coleção, gravando a chave e o valor de cada atributo na 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

Comentários

Itens individuais na coleção retornam um String objeto como seu valor. Se não houver itens de atributo na coleção, a coleção retornará null.

Os atributos em um controle de servidor HTML estão disponíveis programaticamente por meio da Attributes propriedade, que é herdada por todos os controles de servidor HTML. ASP.NET expõe atributos de controles de servidor HTML como propriedades desses controles.

Você pode adicionar atributos a um controle de servidor Web por meio da Attributes propriedade, que é herdada por todos os controles do servidor Web. Os atributos na coleção de atributos de um controle de servidor Web não correspondem necessariamente às propriedades fortemente tipadas do controle para esse controle.

Confira também

• Attributes
• Attributes