AttributeCollection Sınıf

Tanım

Ad Alanı:

System.Web.UI

Bütünleştirilmiş Kod:

System.Web.dll

bir ASP.NET sunucu denetim öğesinin açılış etiketinde bildirilen tüm özniteliklere nesne modeli erişimi sağlar. Bu sınıf devralınamaz.

public ref class AttributeCollection sealed

public sealed class AttributeCollection

type AttributeCollection = class

Public NotInheritable Class AttributeCollection

Devralma

Object

AttributeCollection

Örnekler

Aşağıdaki örnek adlı myAttributeCollectionyeni AttributeCollection bir nesne oluşturur ve ardından sayfanın geri gönderilip gönderilmediğini denetler. Yoksa, kod koleksiyona iki öznitelik ekler. Ardından koleksiyondaki özniteliklerin sayısını alır ve her özniteliğin anahtarını sayfaya yazarak koleksiyonda yinelenir. Sayfa geri gönderme ise, kod yeni öznitelik sayısını alır ve her özniteliğin anahtarını ve değerini sayfaya yazarak koleksiyonda yinelenir.

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

Açıklamalar

Koleksiyondaki tek tek öğeler, değerleri olarak bir String nesne döndürür. Koleksiyonda öznitelik öğesi yoksa, koleksiyon döndürür null.

HTML sunucusu denetimindeki öznitelikler, tüm HTML sunucusu denetimleri tarafından devralınan Attributes özelliği aracılığıyla program aracılığıyla kullanılabilir. ASP.NET, HTML sunucusu denetimlerinin özniteliklerini bu denetimlerin özellikleri olarak kullanıma sunar.

Tüm Web sunucusu denetimleri tarafından devralınan Attributes özelliği aracılığıyla bir Web sunucusu denetimine öznitelik ekleyebilirsiniz. Bir Web sunucusu denetimi için öznitelik koleksiyonundaki öznitelikler, denetimin bu denetim için kesin olarak yazılan özelliklerine karşılık gelmez.

Oluşturucular

Name	Description
AttributeCollection(StateBag)	AttributeCollection sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
Count	Nesnedeki AttributeCollection öznitelik sayısını alır.
CssStyle	Geçerli AttributeCollection nesnenin ait olduğu ASP.NET sunucu denetimi için stil koleksiyonunu alır.
Item[String]	Sunucu denetimi için belirtilen öznitelik değerini alır veya ayarlar.
Keys	Sunucu denetiminin AttributeCollection nesnesindeki tüm özniteliklerin anahtar koleksiyonunu alır.

Yöntemler

Name	Description
Add(String, String)	Sunucu denetiminin AttributeCollection nesnesine öznitelik ekler.
AddAttributes(HtmlTextWriter)	sınıfından AttributeCollectionHtmlTextWriter öznitelikleri, öznitelikleri işaretleme olarak işlemekten sorumlu olan nesneye ekler.
Clear()	Sunucu denetiminin AttributeCollection nesnesinden tüm öznitelikleri kaldırır.
Equals(Object)	Nesnenin geçerli örneğinin AttributeCollection belirtilen nesneye eşit olup olmadığını belirler.
GetHashCode()	Bu örneğin karma kodunu döndürür.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
Remove(String)	Bir sunucu denetiminin AttributeCollection nesnesinden özniteliği kaldırır.
Render(HtmlTextWriter)	Öznitelik koleksiyonunu, koleksiyonun ait olduğu denetim için belirtilen HtmlTextWriter çıkış akışına yazar.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• Attributes
• Attributes