AttributeCollection Klasa

Definicja

Zapewnia dostęp modelu obiektu do wszystkich atrybutów zadeklarowanych w tagu otwierającym elementu formantu serwera ASP.NET.Provides object-model access to all attributes declared in the opening tag of an ASP.NET server control element. Klasa ta nie może być dziedziczona.This class cannot be inherited.

public ref class AttributeCollection sealed
public sealed class AttributeCollection
type AttributeCollection = class
Public NotInheritable Class AttributeCollection
Dziedziczenie
AttributeCollection

Przykłady

Poniższy przykład tworzy nowy AttributeCollection obiekt o nazwie myAttributeCollection , a następnie sprawdza, czy strona została opublikowana.The following example creates a new AttributeCollection object that is named myAttributeCollection, and then checks whether the page has been posted back. Jeśli nie, kod dodaje dwa atrybuty do kolekcji.If it has not, the code adds two attributes to the collection. Następnie pobiera liczbę atrybutów w kolekcji i wykonuje iterację w kolekcji, pisząc klucz do każdego atrybutu na stronie.It then gets the number of attributes in the collection and iterates through the collection, writing the key to each attribute to the page. Jeśli strona jest ogłaszania zwrotnego, kod pobiera nową liczbę atrybutów i wykonuje iterację kolekcji, pisząc klucz i wartość każdego atrybutu na stronie.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

Uwagi

Poszczególne elementy w kolekcji zwracają String obiekt jako ich wartość.Individual items in the collection return a String object as their value. Jeśli kolekcja nie zawiera żadnych elementów, kolekcja zwraca wartość null .If there are no attribute items in the collection, the collection returns null.

Atrybuty kontrolki serwera HTML są programowo dostępne za pomocą Attributes właściwości, która jest dziedziczona przez wszystkie kontrolki serwera HTML.Attributes on an HTML server control are programmatically available through the Attributes property, which is inherited by all HTML server controls. ASP.NET uwidacznia atrybuty formantów serwera HTML jako właściwości tych kontrolek.ASP.NET exposes attributes of HTML server controls as properties of those controls.

Można dodać atrybuty do kontrolki serwera sieci Web za pomocą Attributes właściwości, która jest dziedziczona przez wszystkie formanty serwera sieci Web.You can add attributes to a Web server control through the Attributes property, which is inherited by all Web server controls. Atrybuty w kolekcji atrybutów dla kontrolki serwera sieci Web nie muszą odpowiadać właściwości jednoznacznie wpisanej kontrolki dla tej kontrolki.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)

Inicjuje nowe wystąpienie klasy AttributeCollection.Initializes a new instance of the AttributeCollection class.

Właściwości

Count

Pobiera liczbę atrybutów w AttributeCollection obiekcie.Gets the number of attributes in the AttributeCollection object.

CssStyle

Pobiera kolekcję stylów dla formantu serwera ASP.NET, do którego AttributeCollection należy bieżący obiekt.Gets a collection of styles for the ASP.NET server control to which the current AttributeCollection object belongs.

Item[String]

Pobiera lub ustawia wartość określonej wartości atrybutu dla kontrolki serwerowej.Gets or sets a specified attribute value for a server control.

Keys

Pobiera kolekcję kluczy do wszystkich atrybutów w obiekcie formantu serwera AttributeCollection .Gets a collection of keys to all attributes in the server control's AttributeCollection object.

Metody

Add(String, String)

Dodaje atrybut do obiektu formantu serwera AttributeCollection .Adds an attribute to a server control's AttributeCollection object.

AddAttributes(HtmlTextWriter)

Dodaje atrybuty z AttributeCollection klasy do HtmlTextWriter obiektu, który jest odpowiedzialny za renderowanie atrybutów jako znaczników.Adds attributes from the AttributeCollection class to the HtmlTextWriter object that is responsible for rendering the attributes as markup.

Clear()

Usuwa wszystkie atrybuty z obiektu formantu serwera AttributeCollection .Removes all attributes from a server control's AttributeCollection object.

Equals(Object)

Określa, czy bieżące wystąpienie AttributeCollection obiektu jest równe podanemu obiektowi.Determines whether the current instance of the AttributeCollection object is equal to the specified object.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Zwraca wartość skrótu dla tego wystąpienia.Returns the hash code for this instance.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
Remove(String)

Usuwa atrybut z obiektu formantu serwera AttributeCollection .Removes an attribute from a server control's AttributeCollection object.

Render(HtmlTextWriter)

Zapisuje kolekcję atrybutów do określonego HtmlTextWriter strumienia wyjściowego dla kontrolki, do której należy kolekcja.Writes the collection of attributes to the specified HtmlTextWriter output stream for the control to which the collection belongs.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Dotyczy

Zobacz też