EmptyControlCollection 类

定义

命名空间:

System.Web.UI

程序集:

System.Web.dll

对始终为空白的 ControlCollection 集合提供标准支持。

public ref class EmptyControlCollection : System::Web::UI::ControlCollection

public class EmptyControlCollection : System.Web.UI.ControlCollection

type EmptyControlCollection = class
    inherit ControlCollection

Public Class EmptyControlCollection
Inherits ControlCollection

继承

Object

ControlCollection

EmptyControlCollection

示例

/* File name: emptyControlCollection.cs. */

using System;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Collections;

namespace CustomControls
{

  // Defines a simple custom control.
  public class MyCS_EmptyControl : Control
  {
    [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
    protected override ControlCollection CreateControlCollection() 
    /*
     * Function Name: CreateControlCollection.
     * Denies the creation of any child control by creating an empty collection.
     * Generates an exception if an attempt to create a child control is made.
     */
     {
       return new EmptyControlCollection(this);
     }
     
     [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
     protected override void CreateChildControls()
     /*
      * Function Name: CreateChildControls.
      * Populates the child control collection (Controls). 
      * Note: This function will cause an exception because the control does not allow 
      * child controls.
      */
      {
        // Create a literal control to contain the header and add it to the collection.
        LiteralControl text;
        text = new LiteralControl("<h5>Composite Controls</h5>");
        Controls.Add(text);
      }
   }
}

' File name: emptyControlCollection.vb.

Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Collections


Namespace CustomControls 

  Public Class MyVB_EmptyControl 
    Inherits Control
    
    <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
    Protected Overrides Function CreateControlCollection() As ControlCollection
    ' Function Name: CreateControlCollection.
    ' Denies the creation of any child control by creating an empty collection.
    ' Generates an exception if an attempt to create a child control is made.
      Return New EmptyControlCollection(Me)
    End Function 
    
    <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _  
    Protected Overrides Sub CreateChildControls()
    ' Sub Name: CreateChildControls.
    ' Populates the child control collection (Controls). 
    ' Note: This function will cause an exception because the control does not allow 
    ' child controls.
      Dim text As LiteralControl
      text = New LiteralControl("<h5>Composite Controls</h5>")
      Controls.Add(text)
    End Sub 
  End Class 

End Namespace

注解

如果要定义不允许子控件的自定义控件，则使用此类。

构造函数

EmptyControlCollection(Control)

初始化 EmptyControlCollection 类的新实例。

属性

Count	为指定的 ASP.NET 服务器控件获取 ControlCollection 对象中的服务器控件数。 (继承自 ControlCollection)
IsReadOnly	获取一个值，该值指示 ControlCollection 对象是否为只读。 (继承自 ControlCollection)
IsSynchronized	获取一个值，该值指示是否同步 ControlCollection 对象。 (继承自 ControlCollection)
Item[Int32]	获取对 ControlCollection 对象中指定索引位置的服务器控件的引用。 (继承自 ControlCollection)
Owner	获取 ControlCollection 对象所属的 ASP.NET 服务器控件。 (继承自 ControlCollection)
SyncRoot	获取可用于同步控件集合访问的对象。 (继承自 ControlCollection)

方法

Add(Control)	拒绝将指定的 Control 对象添加到集合中。
AddAt(Int32, Control)	拒绝将指定的 Control 对象添加到集合中的指定索引位置。
Clear()	从当前服务器控件的 ControlCollection 对象中移除所有控件。 (继承自 ControlCollection)
Contains(Control)	确定指定的服务器控件是否在父服务器控件的 ControlCollection 对象中。 (继承自 ControlCollection)
CopyTo(Array, Int32)	从 ControlCollection 中的指定索引位置开始，将 Array 对象中存储的子控件复制到 Array 对象。 (继承自 ControlCollection)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetEnumerator()	检索可遍历 ControlCollection 对象的枚举器。 (继承自 ControlCollection)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
IndexOf(Control)	检索集合中指定 Control 对象的索引。 (继承自 ControlCollection)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
Remove(Control)	从父服务器控件的 ControlCollection 对象中移除指定服务器控件。 (继承自 ControlCollection)
RemoveAt(Int32)	从 ControlCollection 对象中移除指定索引位置处的子控件。 (继承自 ControlCollection)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

扩展方法

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