AttributeCollection Classe

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Fornece acesso de modelo de objeto a todos os atributos declarados na marca de abertura de um elemento de controle de servidor ASP.NET. Essa classe não pode ser herdada.

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 por meio da coleção, escrevendo 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 de servidor Web. Os atributos na coleção de atributos para um controle de servidor Web não correspondem necessariamente às propriedades fortemente tipadas do controle para esse controle.

Construtores

AttributeCollection(StateBag)

Inicializa uma nova instância da classe AttributeCollection.

Propriedades

Count	Obtém o número de atributos no objeto AttributeCollection.
CssStyle	Obtém uma coleção de estilos para o controle de servidor ASP.NET ao qual o objeto AttributeCollection atual pertence.
Item[String]	Obtém ou define um valor de atributo especificado para um controle de servidor.
Keys	Obtém uma coleção de chaves para todos os atributos no objeto AttributeCollection do controle do servidor.

Métodos

Add(String, String)	Adiciona um atributo a um objeto AttributeCollection de controle de servidor.
AddAttributes(HtmlTextWriter)	Adiciona atributos da classe AttributeCollection ao objeto HtmlTextWriter que é responsável por processar os atributos como marcação.
Clear()	Remove todos os atributos de um objeto AttributeCollection do controle de servidor.
Equals(Object)	Determina se a instância atual do objeto AttributeCollection é igual ao objeto especificado.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Retorna o código hash para a instância.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Remove(String)	Remove um atributo de um objeto AttributeCollection do controle de servidor.
Render(HtmlTextWriter)	Grava a coleção de atributos no fluxo de saída HtmlTextWriter especificado para o controle ao qual a coleção pertence.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• Attributes
• Attributes