Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

Control.ControlCollection.Count Property

.NET Framework 1.1

Gets the total number of Control objects in the collection.

[Visual Basic]
Public Overridable ReadOnly Property Count As Integer  Implements _
   ICollection.Count
[C#]
public virtual int Count {get;}
[C++]
public: __property virtual int get_Count();
[JScript]
public function get Count() : int;

Property Value

The total number of Control objects in the collection.

Implements

ICollection.Count

Remarks

The Count property holds the number of Control objects assigned to the collection. You can use the Count property value as the upper bounds of a loop to iterate through a collection.

Because the index value of a collection is a zero-based index, you must subtract one from the looping variable. If you do not account for this, you will exceed the upper bounds of the collection and throw an IndexOutOfRangeException exception.

Example

[Visual Basic, C#, C++] The following example removes the first Control in the Control.ControlCollection of the derived class Panel if the count of the collection is greater than zero. The example assumes you have created a Panel, a Button, and at least one other control on a Form. The other control(s) are added to the Panel control, and the Panel control added to the Form. When the button is clicked, the first control contained in the panel is removed from the Control.ControlCollection.

[Visual Basic] 
' Remove the first control in the collection.
Private Sub RemoveAtButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles RemoveAtButton.Click
    If (Panel1.Controls.Count > 0) Then
        Panel1.Controls.RemoveAt(0)
    End If
End Sub

[C#] 
// Remove the first control in the collection.
private void removeAtButton_Click(object sender, System.EventArgs e)
{
   if (panel1.Controls.Count > 0)
   {
      panel1.Controls.RemoveAt(0);
   }
}

[C++] 
// Remove the first control in the collection.
private:
void removeAtButton_Click(Object* /*sender*/, System::EventArgs* /*e*/) {
    if (panel1->Controls->Count > 0) {
        panel1->Controls->RemoveAt(0);
    }
}

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

See Also

Control.ControlCollection Class | Control.ControlCollection Members | System.Windows.Forms Namespace

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.