AttributeCollection Třída

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Poskytuje přístup objektového modelu ke všem atributům deklarovaným v počáteční značce elementu řízení serveru ASP.NET. Tuto třídu nelze zdědit.

public ref class AttributeCollection sealed

public sealed class AttributeCollection

type AttributeCollection = class

Public NotInheritable Class AttributeCollection

Dědičnost

Object

AttributeCollection

Příklady

Následující příklad vytvoří nový AttributeCollection objekt, který je pojmenován myAttributeCollection, a pak zkontroluje, zda byla stránka publikována zpět. Pokud tomu tak není, kód přidá do kolekce dva atributy. Potom získá počet atributů v kolekci a iteruje kolekci a zapíše klíč ke každému atributu na stránku. Pokud je stránka postback, kód získá nový počet atributů a iteruje prostřednictvím kolekce, zapíše klíč a hodnotu každého atributu na stránku.

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

Poznámky

Jednotlivé položky v kolekci vrátí String objekt jako jejich hodnotu. Pokud v kolekci nejsou žádné položky atributů, vrátí nullse kolekce .

Atributy na ovládacím prvku serveru HTML jsou prostřednictvím kódu programu dostupné prostřednictvím Attributes vlastnosti, která je zděděna všemi ovládacími prvky serveru HTML. ASP.NET zveřejňuje atributy ovládacích prvků serveru HTML jako vlastnosti těchto ovládacích prvků.

Atributy lze přidat do ovládacího prvku webového serveru prostřednictvím Attributes vlastnosti, která je zděděna všemi ovládacími prvky webového serveru. Atributy v kolekci atributů pro ovládací prvek webového serveru nemusí nutně odpovídat vlastnosti ovládacího prvku silného typu pro tento ovládací prvek.

Konstruktory

Name	Description
AttributeCollection(StateBag)	Inicializuje novou instanci AttributeCollection třídy.

Vlastnosti

Name	Description
Count	Získá počet atributů v objektu AttributeCollection .
CssStyle	Získá kolekci stylů pro ASP.NET server řízení, ke kterému patří aktuální AttributeCollection objekt.
Item[String]	Získá nebo nastaví zadanou hodnotu atributu pro server řízení.
Keys	Získá kolekci klíčů ke všem atributům v objektu AttributeCollection ovládacího prvku serveru.

Metody

Name	Description
Add(String, String)	Přidá atribut do objektu AttributeCollection ovládacího prvku serveru.
AddAttributes(HtmlTextWriter)	Přidá atributy z AttributeCollection třídy do objektu HtmlTextWriter , který je zodpovědný za vykreslení atributů jako revize.
Clear()	Odebere všechny atributy z objektu AttributeCollection ovládacího prvku serveru.
Equals(Object)	Určuje, zda aktuální instance objektu AttributeCollection je rovna zadanému objektu.
GetHashCode()	Vrátí kód hash pro tuto instanci.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
Remove(String)	Odebere atribut z objektu AttributeCollection ovládacího prvku serveru.
Render(HtmlTextWriter)	Zapíše kolekci atributů do zadaného HtmlTextWriter výstupního datového proudu pro ovládací prvek, do kterého kolekce patří.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• Attributes
• Attributes