AttributeCollection Třída

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Poskytuje přístup modelu objektu pro všechny atributy deklarované v otevírací značce ASP.NET server ovládací prvek. Tuto třídu nelze dě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 s názvem myAttributeCollectiona poté zkontroluje, zda byla stránka odeslána zpět. Pokud ne, kód přidá do kolekce dva atributy. Pak získá počet atributů v kolekci a iteruje kolekci a zapíše klíč ke každému atributu na stránce. Pokud je stránka postback, kód získá nový počet atributů a iteruje kolekci a 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 vrací String objekt jako svoji hodnotu. Pokud v kolekci nejsou žádné položky atributu, vrátí nullkolekce hodnotu .

Atributy serverového ovládacího prvku HTML jsou programově 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 ovládacího prvku webového serveru můžete přidat prostřednictvím Attributes vlastnosti , která je zděděna všemi ovládacími prvky webového serveru. Atributy v kolekci atributů ovládacího prvku webového serveru nemusí nutně odpovídat vlastnostem ovládacího prvku silného typu pro tento ovládací prvek.

Konstruktory

AttributeCollection(StateBag)

Inicializuje novou instanci AttributeCollection třídy .

Vlastnosti

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

Metody

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

Viz také

• Attributes
• Attributes