AttributeCollection Klasa

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.dll

Zapewnia dostęp modelu obiektów do wszystkich atrybutów zadeklarowanych w tagu otwierania elementu kontroli serwera ASP.NET. Klasa ta nie może być dziedziczona.

public ref class AttributeCollection sealed

public sealed class AttributeCollection

type AttributeCollection = class

Public NotInheritable Class AttributeCollection

Dziedziczenie

Object

AttributeCollection

Przykłady

Poniższy przykład tworzy nowy AttributeCollection obiekt o nazwie myAttributeCollection, a następnie sprawdza, czy strona została opublikowana z powrotem. Jeśli tak nie jest, kod dodaje dwa atrybuty do kolekcji. Następnie pobiera liczbę atrybutów w kolekcji i iteruje po kolekcji, zapisuj klucz do każdego atrybutu na stronie. Jeśli strona jest ogłaszaniem zwrotnym, kod pobiera nową liczbę atrybutów i iteruje po kolekcji, zapisuj klucz i wartość każdego atrybutu na stronie.

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

Uwagi

Poszczególne elementy w kolekcji zwracają String obiekt jako ich wartość. Jeśli w kolekcji nie ma żadnych elementów atrybutów, kolekcja zwraca wartość null.

Atrybuty w kontrolce serwera HTML są programowo dostępne za pośrednictwem Attributes właściwości, która jest dziedziczona przez wszystkie kontrolki serwera HTML. ASP.NET uwidacznia atrybuty kontrolek serwera HTML jako właściwości tych kontrolek.

Atrybuty można dodać do kontrolki serwera sieci Web za pomocą Attributes właściwości , która jest dziedziczona przez wszystkie kontrolki serwera sieci Web. Atrybuty w kolekcji atrybutów dla kontrolki serwera sieci Web niekoniecznie odpowiadają silnie typizowane właściwości tej kontrolki.

Konstruktory

AttributeCollection(StateBag)

Inicjuje nowe wystąpienie klasy AttributeCollection.

Właściwości

Count	Pobiera liczbę atrybutów w AttributeCollection obiekcie .
CssStyle	Pobiera kolekcję stylów dla kontrolki serwera ASP.NET, do której należy bieżący AttributeCollection obiekt.
Item[String]	Pobiera lub ustawia określoną wartość atrybutu dla kontrolki serwera.
Keys	Pobiera kolekcję kluczy do wszystkich atrybutów w obiekcie kontrolki AttributeCollection serwera.

Metody

Add(String, String)	Dodaje atrybut do obiektu kontrolki AttributeCollection serwera.
AddAttributes(HtmlTextWriter)	Dodaje atrybuty z AttributeCollection klasy do HtmlTextWriter obiektu, który jest odpowiedzialny za renderowanie atrybutów jako znaczników.
Clear()	Usuwa wszystkie atrybuty z obiektu kontrolki AttributeCollection serwera.
Equals(Object)	Określa, czy bieżące wystąpienie AttributeCollection obiektu jest równe określonemu obiektowi.
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Remove(String)	Usuwa atrybut z obiektu kontrolki AttributeCollection serwera.
Render(HtmlTextWriter)	Zapisuje kolekcję atrybutów do określonego HtmlTextWriter strumienia wyjściowego dla kontrolki, do której należy kolekcja.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• Attributes
• Attributes