ControlCollection.Item-Eigenschaft

Artikel
08/20/2007

Ruft im ControlCollection-Objekt an der angegebenen Indexposition einen Verweis auf das Serversteuerelement ab.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Overridable ReadOnly Default Property Item ( _
    index As Integer _
) As Control
'Usage
Dim instance As ControlCollection
Dim index As Integer
Dim value As Control

value = instance(index)

public virtual Control this [
    int index
] { get; }

public:
virtual property Control^ default [int] {
    Control^ get (int index);
}

/** @property */
public Control get_Item (int index)

JScript unterstützt die Verwendung von indizierten Eigenschaften, aber nicht die Deklaration von neuen indizierten Eigenschaften.

Parameter

index
Die Position des Serversteuerelements in ControlCollection.

Eigenschaftenwert

Der Verweis auf das Steuerelement.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentOutOfRangeException	Der index-Parameter ist kleiner als 0 (null) oder größer oder gleich ControlCollection.Count.

Beispiel

Im folgenden Codebeispiel wird anhand der Item-Eigenschaft die Indexposition eines untergeordneten Steuerelements angegeben, das durch einen Aufruf der Remove-Methode entfernt wird. Dies wird durch die myButton.Controls.Remove-Syntax durchgeführt.

<html>
   <head>
      <script language="VB" runat="server">
   Sub Page_Load( Sender as Object,e as EventArgs )
      Response.Write("<h2><Center><b><font color=blue> Sample for ControlCollection Class</font></h2></Center></b>")
      Dim  myLiteralControl as LiteralControl=new LiteralControl("ChildControl1")
      myButton.Controls.Add(myLiteralControl)
      myButton.Controls.AddAt(1,new LiteralControl("ChildControl2"))

      Dim myControlCollectionArray as System.Array = _
                     Array.CreateInstance(GetType(object),myButton.Controls.Count)
      myButton.Controls.CopyTo(myControlCollectionArray,0)
      Dim myEnumerator1 as IEnumerator= myControlCollectionArray.GetEnumerator()
      while (myEnumerator1.MoveNext())
         Dim myObject as object = myEnumerator1.Current
         if(myObject.GetType().Equals(GetType(LiteralControl)))
            Dim childControl as LiteralControl=CType(myEnumerator1.Current,LiteralControl)
            Response.Write("<b><br> This is the  text of the child Control  </b>:" _
                           + Server.HtmlEncode(childControl.Text))
         End If
      End While

      myButton.Controls.Remove(myButton.Controls(0))
      Response.Write("<br><b>ChildControl1 is removed</b>")
      Response.Write("<br><b> The count of ControlCollection </b>" _
                     +myButton.Controls.Count.ToString())
      myButton.Controls.Clear()

   End Sub
      </script>
   </head>
   <body MS_POSITIONING="GridLayout">
      <form id="Form1" method="post" runat="server">
         <asp:Button ID="myButton" Text="Sample ServerControl" Runat="server"></asp:Button>
      </form>
   </body>
</html>

<html>
   <head>
      <script language="cs" runat="server">
   void Page_Load(Object Sender,EventArgs e)
   {
      Response.Write("<h2><Center><b><font color=blue> Sample for ControlCollection Class</font></h2></Center></b>");
      LiteralControl myLiteralControl=new LiteralControl("ChildControl1");
      myButton.Controls.Add(myLiteralControl);
      myButton.Controls.AddAt(1,new LiteralControl("ChildControl2"));

      System.Array myControlCollectionArray =Array.CreateInstance(typeof(object),myButton.Controls.Count);
      myButton.Controls.CopyTo(myControlCollectionArray,0);
      IEnumerator myEnumerator1= myControlCollectionArray.GetEnumerator();
      while (myEnumerator1.MoveNext())
      {
         object myObject = myEnumerator1.Current;
         if(myObject.GetType().Equals(typeof(LiteralControl)))
         {
            LiteralControl childControl=(LiteralControl)myEnumerator1.Current;
            Response.Write("<b><br> This is the  text of the child Control  </b>:"
                           + Server.HtmlEncode(childControl.Text));
         }
      }

      myButton.Controls.Remove(myButton.Controls[0]);
      Response.Write("<br><b>ChildControl1 is removed</b>");
      Response.Write("<br><b> The count of ControlCollection </b>"
                     +myButton.Controls.Count);
      myButton.Controls.Clear();
   }
      </script>
   </head>
   <body MS_POSITIONING="GridLayout">
      <form id="Form1" method="post" runat="server">
         <asp:Button ID="myButton" Text="Sample ServerControl" Runat="server"></asp:Button>
      </form>
   </body>
</html>

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ControlCollection-Klasse
ControlCollection-Member
System.Web.UI-Namespace
Control.Controls-Eigenschaft

Freigeben über