Control.ControlCollection 类

参考

定义

命名空间:: System.Windows.Forms

程序集:: System.Windows.Forms.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

表示 Control 对象集合。

public: ref class Control::ControlCollection : ICloneable, System::Collections::IList

public: ref class Control::ControlCollection : System::Windows::Forms::Layout::ArrangedElementCollection, ICloneable, System::Collections::IList

[System.ComponentModel.ListBindable(false)]
public class Control.ControlCollection : ICloneable, System.Collections.IList

[System.ComponentModel.ListBindable(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public class Control.ControlCollection : System.Windows.Forms.Layout.ArrangedElementCollection, ICloneable, System.Collections.IList

[System.ComponentModel.ListBindable(false)]
public class Control.ControlCollection : System.Windows.Forms.Layout.ArrangedElementCollection, ICloneable, System.Collections.IList

[<System.ComponentModel.ListBindable(false)>]
type Control.ControlCollection = class
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable

[<System.ComponentModel.ListBindable(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
type Control.ControlCollection = class
    inherit ArrangedElementCollection
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable

[<System.ComponentModel.ListBindable(false)>]
type Control.ControlCollection = class
    inherit ArrangedElementCollection
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable

Public Class Control.ControlCollection
Implements ICloneable, IList

Public Class Control.ControlCollection
Inherits ArrangedElementCollection
Implements ICloneable, IList

继承: Object
Control.ControlCollection

继承: Object

ArrangedElementCollection
Control.ControlCollection

派生: System.Windows.Forms.DataGridView.DataGridViewControlCollection

System.Windows.Forms.Form.ControlCollection

System.Windows.Forms.MdiClient.ControlCollection

System.Windows.Forms.TabControl.ControlCollection

System.Windows.Forms.TableLayoutControlCollection

更多…

属性: ListBindableAttribute ComVisibleAttribute

实现: ICollection IEnumerable IList ICloneable

示例

如果派生类是集合的成员，则以下代码示例从派生类Panel中删除 Control Control.ControlCollection a。该示例要求你已创建一个Panel、一个Button和至少一个RadioButton控件。Form 控件 RadioButton 将添加到 Panel 控件，以及 Panel 添加到控件中的 Form控件。 When the button is clicked, the radio button named radioButton2 is removed from the Control.ControlCollection.

   // 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 Sub RemoveButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles RemoveButton.Click
    If Panel1.Controls.Contains(RemoveButton) Then
        Panel1.Controls.Remove(RemoveButton)
    End If
End Sub

注解

通过和Add Remove RemoveAt方法，可以添加和删除集合中的单个控件。还可以使用 AddRange 或 Clear 方法添加或删除集合中的所有控件。

可以通过将控件Contains传递到方法来确定某个Control集合是否是集合的成员。若要获取集合中某个 Control 位置的索引值，请将控件 IndexOf 传递到方法中。可以通过调用 CopyTo 该方法将集合复制到数组中。

构造函数

Control.ControlCollection(Control)

初始化 Control.ControlCollection 类的新实例。

属性

Count	获取集合中包含的元素数。
Count	获取集合中的元素数。 (继承自 ArrangedElementCollection)
IsReadOnly	获取一个值，它指示此集合对象是否是只读的。
IsReadOnly	获取一个值，该值指示集合是否为只读。 (继承自 ArrangedElementCollection)
Item[Int32]	指示位于集合中指定索引位置的 Control。
Item[String]	指示集合中具有指定键的一个 Control。
Owner	获取拥有此 Control.ControlCollection 的控件。

方法

Add(Control)	将指定的控件添加到控件集合中。
AddRange(Control[])	将控件对象数组添加到集合中。
Clear()	从集合中移除所有控件。
Contains(Control)	确定指定控件是否为集合的成员。
ContainsKey(String)	确定 Control.ControlCollection 是否包含具有指定键的项。
CopyTo(Array, Int32)	从特定的数组索引开始，将集合的元素复制到数组中。
CopyTo(Array, Int32)	从目标数组的指定索引处开始将此集合的全部内容复制到兼容的一维 Array。 (继承自 ArrangedElementCollection)
Equals(Object)	指定当前集合对象和所指定的对象是否相等。
Equals(Object)	确定两个 ArrangedElementCollection 实例是否相等。 (继承自 ArrangedElementCollection)
Find(String, Boolean)	根据控件的 Name 属性搜索控件并生成由所有匹配项组成的数组。
GetChildIndex(Control)	检索控件集合内的指定子控件的索引。
GetChildIndex(Control, Boolean)	检索控件集合内的指定子控件的索引，并且如果指定控件不在控件集合内，也可能引发异常。
GetEnumerator()	检索对用于循环访问 Control.ControlCollection 的枚举数对象的引用。
GetHashCode()	返回此实例的哈希代码。
GetHashCode()	返回此实例的哈希代码。 (继承自 ArrangedElementCollection)
GetType()	获取当前实例的 Type。 (继承自 Object)
IndexOf(Control)	检索控件集合中指定控件的索引。
IndexOfKey(String)	检索指定项在集合中的第一个匹配项的索引。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
Remove(Control)	从控件集合中移除指定的控件。
RemoveAt(Int32)	在指定的索引位置从控件集合移除控件。
RemoveByKey(String)	移除具有指定键的子控件。
SetChildIndex(Control, Int32)	将集合中的指定子控件的索引设置为指定的索引值。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

显式接口实现

ICloneable.Clone()	此 API 支持产品基础结构，不能在代码中直接使用。有关此成员的说明，请参见 Clone()。
ICollection.IsSynchronized	有关此成员的说明，请参见 IsSynchronized 属性。 (继承自 ArrangedElementCollection)
ICollection.SyncRoot	有关此成员的说明，请参见 SyncRoot 属性。 (继承自 ArrangedElementCollection)
IList.Add(Object)	此 API 支持产品基础结构，不能在代码中直接使用。有关此成员的说明，请参见 Add(Object)。
IList.Clear()	有关此成员的说明，请参见 Clear() 方法。 (继承自 ArrangedElementCollection)
IList.Contains(Object)	此 API 支持产品基础结构，不能在代码中直接使用。有关此成员的说明，请参见 Contains(Object)。
IList.Contains(Object)	有关此成员的说明，请参见 Contains(Object) 方法。 (继承自 ArrangedElementCollection)
IList.IndexOf(Object)	此 API 支持产品基础结构，不能在代码中直接使用。有关此成员的说明，请参见 IndexOf(Object)。
IList.IndexOf(Object)	有关此成员的说明，请参见 IndexOf(Object) 方法。 (继承自 ArrangedElementCollection)
IList.Insert(Int32, Object)	此 API 支持产品基础结构，不能在代码中直接使用。有关此成员的说明，请参见 Insert(Int32, Object)。
IList.Insert(Int32, Object)	有关此成员的说明，请参见 Insert(Int32, Object) 方法。 (继承自 ArrangedElementCollection)
IList.IsFixedSize	有关此成员的说明，请参见 IsFixedSize 属性。 (继承自 ArrangedElementCollection)
IList.Item[Int32]	有关此成员的说明，请参见 Item[Int32] 属性。 (继承自 ArrangedElementCollection)
IList.Remove(Object)	此 API 支持产品基础结构，不能在代码中直接使用。有关此成员的说明，请参见 Remove(Object)。
IList.RemoveAt(Int32)	有关此成员的说明，请参见 RemoveAt(Int32) 方法。 (继承自 ArrangedElementCollection)

扩展方法

Cast<TResult>(IEnumerable)	将 IEnumerable 的元素强制转换为指定的类型。
OfType<TResult>(IEnumerable)	根据指定类型筛选 IEnumerable 的元素。
AsParallel(IEnumerable)	启用查询的并行化。
AsQueryable(IEnumerable)	将 IEnumerable 转换为 IQueryable。

适用于

通过

Control.ControlCollection 类

定义

示例

注解

构造函数

属性

方法

显式接口实现

扩展方法

适用于

另请参阅

其他资源