EmptyControlCollection Klasse

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Bietet Standardunterstützung für eine ControlCollection Sammlung, die immer leer ist.

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

Vererbung

Object

ControlCollection

EmptyControlCollection

Beispiele

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

Hinweise

Diese Klasse wird verwendet, wenn Sie ein benutzerdefiniertes Steuerelement definieren möchten, das untergeordnete Steuerelemente nicht zulässt.

Konstruktoren

Name	Beschreibung
EmptyControlCollection(Control)	Initialisiert eine neue Instanz der EmptyControlCollection-Klasse.

Eigenschaften

Name	Beschreibung
Count	Ruft die Anzahl der Serversteuerelemente im ControlCollection Objekt für das angegebene ASP.NET Serversteuerelement ab. (Geerbt von ControlCollection)
IsReadOnly	Ruft einen Wert ab, der angibt, ob das ControlCollection Objekt schreibgeschützt ist. (Geerbt von ControlCollection)
IsSynchronized	Ruft einen Wert ab, der angibt, ob das ControlCollection Objekt synchronisiert wird. (Geerbt von ControlCollection)
Item[Int32]	Ruft einen Verweis auf das Serversteuerelement an der angegebenen Indexposition im ControlCollection Objekt ab. (Geerbt von ControlCollection)
Owner	Ruft das ASP.NET Serversteuerelement ab, zu dem das ControlCollection Objekt gehört. (Geerbt von ControlCollection)
SyncRoot	Ruft ein Objekt ab, das zum Synchronisieren des Zugriffs auf die Auflistung von Steuerelementen verwendet werden kann. (Geerbt von ControlCollection)

Methoden

Name	Beschreibung
Add(Control)	Verweigert das Hinzufügen des angegebenen Control Objekts zur Auflistung.
AddAt(Int32, Control)	Verweigert das Hinzufügen des angegebenen Control Objekts zur Auflistung an der angegebenen Indexposition.
Clear()	Entfernt alle Steuerelemente aus dem Objekt des aktuellen Serversteuerelements ControlCollection . (Geerbt von ControlCollection)
Contains(Control)	Bestimmt, ob sich das angegebene Serversteuerelement im Objekt des übergeordneten Serversteuerelements ControlCollection befindet. (Geerbt von ControlCollection)
CopyTo(Array, Int32)	Kopiert die im ControlCollection Objekt gespeicherten untergeordneten Steuerelemente in ein Array Objekt, beginnend an der angegebenen Indexposition in der Array. (Geerbt von ControlCollection)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetEnumerator()	Ruft einen Enumerator ab, der das ControlCollection Objekt durchlaufen kann. (Geerbt von ControlCollection)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
IndexOf(Control)	Ruft den Index eines angegebenen Control Objekts in der Auflistung ab. (Geerbt von ControlCollection)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
Remove(Control)	Entfernt das angegebene Serversteuerelement aus dem Objekt des übergeordneten Serversteuerelements ControlCollection . (Geerbt von ControlCollection)
RemoveAt(Int32)	Entfernt ein untergeordnetes Steuerelement an der angegebenen Indexposition aus dem ControlCollection Objekt. (Geerbt von ControlCollection)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Erweiterungsmethoden

Name	Beschreibung
AsParallel(IEnumerable)	Aktiviert die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Wandelt eine IEnumerable in eine IQueryableum.
Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um.
OfType<TResult>(IEnumerable)	Filtert die Elemente einer IEnumerable basierend auf einem angegebenen Typ.