EmptyControlCollection Třída

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Poskytuje standardní podporu kolekce 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á, pokud chcete definovat vlastní ovládací prvek, který neumožňuje podřízené ovládací prvky.

Konstruktory

Name	Description
EmptyControlCollection(Control)	Inicializuje novou instanci EmptyControlCollection třídy.

Vlastnosti

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

Metody

Name	Description
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 ControlCollection ovládacího prvku serveru. (Zděděno od ControlCollection)
Contains(Control)	Určuje, zda je zadaný ovládací prvek serveru v objektu nadřazeného ControlCollection ovládacího prvku serveru. (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čuje, zda je zadaný objekt roven 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í funkce hash. (Zděděno od Object)
GetType()	Získá Type 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 Object. (Zděděno od Object)
Remove(Control)	Odebere zadaný serverový ovládací prvek z objektu nadřazeného ControlCollection ovládacího prvku serveru. (Zděděno od ControlCollection)
RemoveAt(Int32)	Odebere podřízený ovládací prvek v zadaném umístění indexu z objektu 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í

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