AttributeCollection Třída

Definice

Poskytuje přístup model objektu pro všechny atributy deklarované v otevírací značce elementu ovládacího prvku ASP.NET serveru.Provides object-model access to all attributes declared in the opening tag of an ASP.NET server control element. Tuto třídu nelze zdědit.This class cannot be inherited.

public ref class AttributeCollection sealed
public sealed class AttributeCollection
type AttributeCollection = class
Public NotInheritable Class AttributeCollection
Dědičnost
AttributeCollection

Příklady

Následující příklad vytvoří nový AttributeCollection objekt s názvem myAttributeCollection a poté zkontroluje, zda byla stránka publikována zpět.The following example creates a new AttributeCollection object that is named myAttributeCollection, and then checks whether the page has been posted back. Pokud tomu tak není, kód přidá dva atributy do kolekce.If it has not, the code adds two attributes to the collection. Pak Získá počet atributů v kolekci a iterací v kolekci a zapíše klíč na každý atribut na stránce.It then gets the number of attributes in the collection and iterates through the collection, writing the key to each attribute to the page. Pokud je stránka zpětným voláním, kód získá nový počet atributů a provede iteraci v kolekci a zapíše klíč a hodnotu každého atributu stránky.If the page is a postback, the code gets the new number of attributes and iterates through the collection, writing the key and value of each attribute to the page.

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 svou hodnotu.Individual items in the collection return a String object as their value. Pokud kolekce neobsahuje žádné položky atributu, kolekce vrátí null .If there are no attribute items in the collection, the collection returns null.

Atributy na ovládacím prvku HTML serveru jsou programově k dispozici prostřednictvím Attributes vlastnosti, která je zděděna všemi serverovými ovládacími prvky HTML.Attributes on an HTML server control are programmatically available through the Attributes property, which is inherited by all HTML server controls. ASP.NET zpřístupňuje atributy serverových ovládacích prvků HTML jako vlastnosti těchto ovládacích prvků.ASP.NET exposes attributes of HTML server controls as properties of those controls.

Můžete přidat atributy k ovládacímu prvku webového serveru prostřednictvím Attributes vlastnosti, která je děděna všemi ovládacími prvky webového serveru.You can add attributes to a Web server control through the Attributes property, which is inherited by all Web server controls. Atributy v kolekci atributů pro ovládací prvek webového serveru nemusí nutně odpovídat vlastnostem silného typu ovládacího prvku daného ovládacího prvku.The attributes in the attributes collection for a Web server control do not necessarily correspond to the control's strongly typed properties for that control.

Konstruktory

AttributeCollection(StateBag)

Inicializuje novou instanci AttributeCollection třídy.Initializes a new instance of the AttributeCollection class.

Vlastnosti

Count

Získá počet atributů v AttributeCollection objektu.Gets the number of attributes in the AttributeCollection object.

CssStyle

Získá kolekci stylů pro ovládací prvek serveru ASP.NET, ke kterému aktuální AttributeCollection objekt patří.Gets a collection of styles for the ASP.NET server control to which the current AttributeCollection object belongs.

Item[String]

Získá nebo nastaví zadanou hodnotu atributu pro serverový ovládací prvek.Gets or sets a specified attribute value for a server control.

Keys

Získá kolekci klíčů pro všechny atributy v objektu serverového ovládacího prvku AttributeCollection .Gets a collection of keys to all attributes in the server control's AttributeCollection object.

Metody

Add(String, String)

Přidá atribut do objektu serverového ovládacího prvku AttributeCollection .Adds an attribute to a server control's AttributeCollection object.

AddAttributes(HtmlTextWriter)

Přidá atributy z AttributeCollection třídy do HtmlTextWriter objektu, který je zodpovědný za vykreslení atributů jako značek.Adds attributes from the AttributeCollection class to the HtmlTextWriter object that is responsible for rendering the attributes as markup.

Clear()

Odebere všechny atributy z objektu serverového ovládacího prvku AttributeCollection .Removes all attributes from a server control's AttributeCollection object.

Equals(Object)

Určuje, zda je aktuální instance AttributeCollection objektu rovna zadanému objektu.Determines whether the current instance of the AttributeCollection object is equal to the specified object.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.Determines whether the specified object is equal to the current object.

(Zděděno od Object)
GetHashCode()

Vrátí hodnotu hash pro tuto instanci.Returns the hash code for this instance.

GetHashCode()

Slouží jako výchozí funkce hash.Serves as the default hash function.

(Zděděno od Object)
GetType()

Získá Type aktuální instanci.Gets the Type of the current instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří kopii aktuálního seznamu Object .Creates a shallow copy of the current Object.

(Zděděno od Object)
Remove(String)

Odebere atribut z objektu serverového ovládacího prvku AttributeCollection .Removes an attribute from a server control's AttributeCollection object.

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ří.Writes the collection of attributes to the specified HtmlTextWriter output stream for the control to which the collection belongs.

ToString()

Vrátí řetězec, který představuje aktuální objekt.Returns a string that represents the current object.

(Zděděno od Object)

Platí pro

Viz také