EmptyControlCollection Třída

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Poskytuje standardní podporu pro kolekci ControlCollection , která je vždy prázdná.

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

Dědičnost

Object

ControlCollection

EmptyControlCollection

Příklady

/* 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

Poznámky

Tato třída se používá, když chcete definovat vlastní ovládací prvek, který nepovoluje podřízené ovládací prvky.

Konstruktory

EmptyControlCollection(Control)

Inicializuje novou instanci EmptyControlCollection třídy .

Vlastnosti

Count	Získá počet serverových ovládacích prvků v objektu ControlCollection pro zadaný ASP.NET serverový ovládací prvek. (Zděděno od ControlCollection)
IsReadOnly	Získá hodnotu označující, zda ControlCollection je objekt jen pro čtení. (Zděděno od ControlCollection)
IsSynchronized	Získá hodnotu označující, zda ControlCollection je objekt synchronizován. (Zděděno od ControlCollection)
Item[Int32]	Získá odkaz na serverový ovládací prvek v zadaném umístění indexu v objektu ControlCollection . (Zděděno od ControlCollection)
Owner	Získá ASP.NET serverový ovládací prvek, ke kterému ControlCollection objekt patří. (Zděděno od ControlCollection)
SyncRoot	Získá objekt, který lze použít k synchronizaci přístupu ke kolekci ovládacích prvků. (Zděděno od ControlCollection)

Metody

Add(Control)	Odmítne přidání zadaného Control objektu do kolekce.
AddAt(Int32, Control)	Odmítne přidání zadaného Control objektu do kolekce na zadané pozici indexu.
Clear()	Odebere všechny ovládací prvky z objektu aktuálního serverového ControlCollection ovládacího prvku. (Zděděno od ControlCollection)
Contains(Control)	Určuje, zda je zadaný serverový ovládací prvek v objektu nadřazeného serverového ControlCollection ovládacího prvku. (Zděděno od ControlCollection)
CopyTo(Array, Int32)	Zkopíruje podřízené ovládací prvky uložené v objektu ControlCollection do objektu Array počínaje zadaným umístěním indexu v objektu Array. (Zděděno od ControlCollection)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetEnumerator()	Načte enumerátor, který může iterovat objektem ControlCollection . (Zděděno od ControlCollection)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
IndexOf(Control)	Načte index zadaného Control objektu v kolekci. (Zděděno od ControlCollection)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
Remove(Control)	Odebere zadaný serverový ovládací prvek z objektu nadřazeného serverového ControlCollection ovládacího prvku. (Zděděno od ControlCollection)
RemoveAt(Int32)	Odebere z objektu podřízený ovládací prvek v zadaném umístění indexu ControlCollection . (Zděděno od ControlCollection)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Metody rozšíření

Cast<TResult>(IEnumerable)	Přetypuje prvky objektu na IEnumerable zadaný typ.
OfType<TResult>(IEnumerable)	Filtruje prvky objektu IEnumerable na základě zadaného typu.
AsParallel(IEnumerable)	Umožňuje paralelizaci dotazu.
AsQueryable(IEnumerable)	Převede objekt na IEnumerableIQueryable.