AttributeCollection Classe

Definição

Espaço de Nomes:: System.Web.UI

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Fornece acesso ao modelo de objeto a todos os atributos declarados na etiqueta de abertura de um elemento de controlo de servidor ASP.NET. Esta 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 seguinte cria um novo AttributeCollection objeto que é nomeado myAttributeCollection, e depois verifica se a página foi publicada novamente. Se não o fizer, o código adiciona dois atributos à coleção. Depois, obtém o número de atributos na coleção e itera pela coleção, escrevendo a chave de cada atributo na página. Se a página for um postback, o código recebe o novo número de atributos e itera pela 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

Observações

Os itens individuais da coleção devolvem um String objeto como o seu valor. Se não houver itens de atributo na coleção, a coleção devolve null.

Os atributos num controlo de servidor HTML estão disponíveis programaticamente através da Attributes propriedade, que é herdada por todos os controlos do servidor HTML. O ASP.NET expõe atributos dos controlos do servidor HTML como propriedades desses controlos.

Pode adicionar atributos a um controlo de servidor Web através da Attributes propriedade, que é herdado por todos os controlos do servidor Web. Os atributos na coleção de atributos para um controlo de servidor Web não correspondem necessariamente às propriedades fortemente tipadas do controlo para esse controlo.

Construtores

Name	Description
AttributeCollection(StateBag)	Inicializa uma nova instância da AttributeCollection classe.

Propriedades

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

Métodos

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

Aplica-se a

Ver também

Comentários

Esta página foi útil?