Control.HasControls Method
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Determines if the server control contains any child controls.
public:
virtual bool HasControls();
public virtual bool HasControls();
abstract member HasControls : unit -> bool
override this.HasControls : unit -> bool
Public Overridable Function HasControls () As Boolean
true
if the control contains other controls; otherwise, false
.
The following example uses the HasControls method to determine if any controls exist before using the Count property to iterate through a ControlCollection object.
if (HasControls()) {
for (int i=0; i < Controls.Count; i++) {
Controls[i].RenderControl(writer);
}
}
If HasControls() Then
Dim i As Integer
For i = 0 To Controls.Count - 1
Controls(i).RenderControl(writer)
Next i
End If
Since this method simply determines if any child controls exist, it can enhance performance by allowing you to avoid an unnecessary Count property call. Calls to this property require a ControlCollection object to be instantiated. If there are no children, this object creation wastes server resources.
The HasControls() method should be overridden only to change metadata attributes such as EditorBrowsableAttribute. For more information about using attributes, see Attributes.
Product | Versions |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET feedback
.NET is an open source project. Select a link to provide feedback: