EmptyControlCollection クラス

リファレンス

定義

名前空間:: System.Web.UI

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

常に空の 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 に変換します。

適用対象