Control.Controls 属性

获取包含在控件内的控件的集合。

**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）

语法

声明
Public ReadOnly Property Controls As ControlCollection
用法
Dim instance As Control
Dim value As ControlCollection

value = instance.Controls

public ControlCollection Controls { get; }

public:
property ControlCollection^ Controls {
    ControlCollection^ get ();
}

/** @property */
public ControlCollection get_Controls ()

public function get Controls () : ControlCollection

属性值

一个 Control.ControlCollection，它表示控件内包含的控件的集合。

备注

Control 可以充当控件集合的父级。例如，将多个控件添加到 Form 时，每一个控件都是分配给该窗体的 Controls 属性的 Control.ControlCollection 的成员，Controls 属性派生于 Control 类。

可以使用 Control.ControlCollection 类中的可用方法，在分配给 Controls 属性的 Control.ControlCollection 中操作控件。

将多个控件添加到父控件时，建议在初始化要添加的控件之前调用 SuspendLayout 方法。将控件添加到父控件之后，调用 ResumeLayout 方法。这样就可以提高带有许多控件的应用程序的性能。

示例

下面的代码示例从派生类 Panel 的 Control.ControlCollection 中移除一个 Control（如果它是该集合的成员）。该示例要求已在 Form 上创建了一个 Panel、一个 Button 以及至少一个 RadioButton 控件。将 RadioButton 控件添加到 Panel 控件，而将 Panel 控件添加到 Form。单击该按钮时，从 Control.ControlCollection 中移除名为 radioButton2 的单选按钮。

' Remove the RadioButton control if it exists.
Private Sub RemoveButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles RemoveButton.Click
    If Panel1.Controls.Contains(RadioAddRangeButton) Then
        Panel1.Controls.Remove(RadioAddRangeButton)
    End If
End Sub

// Remove the RadioButton control if it exists.
private void removeButton_Click(object sender, System.EventArgs e)
{
   if(panel1.Controls.Contains(removeButton))
   {
      panel1.Controls.Remove(removeButton);
   }
}

   // Remove the RadioButton control if it exists.
private:
   void removeButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      if ( panel1->Controls->Contains( removeButton ) )
      {
         panel1->Controls->Remove( removeButton );
      }
   }

// Remove the RadioButton control if it exists.
private void removeButton_Click(Object sender, System.EventArgs e)
{
    if (panel1.get_Controls().Contains(removeButton)) {
        panel1.get_Controls().Remove(removeButton);
    }
} //removeButton_Click

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

.NET Compact Framework

受以下版本支持：2.0、1.0

请参见

参考

Control 类
Control 成员
System.Windows.Forms 命名空间
Control.ControlCollection
CreateControlsInstance
SuspendLayout
ResumeLayout