EmptyControlCollection Klasse

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bietet Standardunterstützung für eine ControlCollection-Auflistung, 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 keine untergeordneten Steuerelemente zulässt.

Konstruktoren

EmptyControlCollection(Control)

Initialisiert eine neue Instanz der EmptyControlCollection-Klasse.

Eigenschaften

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 schreibgeschützt ist. (Geerbt von ControlCollection)
IsSynchronized	Ruft einen Wert ab, der angibt, ob das ControlCollection-Objekt synchronisiert ist. (Geerbt von ControlCollection)
Item[Int32]	Ruft im ControlCollection-Objekt an der angegebenen Indexposition einen Verweis auf das Serversteuerelement 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, mit dem der Zugriff auf die Steuerelementauflistung synchronisiert werden kann (Geerbt von ControlCollection)

Methoden

Add(Control)	Verweigert das Hinzufügen des angegebenen Control-Objekts zu der Auflistung.
AddAt(Int32, Control)	Verweigert das Hinzufügen des angegebenen Control-Objekts an der angegebenen Indexposition der Auflistung.
Clear()	Entfernt sämtliche Steuerelemente aus dem ControlCollection-Objekt des aktuellen Serversteuerelements. (Geerbt von ControlCollection)
Contains(Control)	Bestimmt, ob sich das angegebene Serversteuerelement im ControlCollection-Objekt des übergeordneten Serversteuerelements befindet (Geerbt von ControlCollection)
CopyTo(Array, Int32)	Kopiert die im ControlCollection-Objekt gespeicherten untergeordneten Steuerelemente in ein Array-Objekt. Dabei wird mit der angegebenen Indexposition im Array begonnen. (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()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den 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 des aktuellen Object. (Geerbt von Object)
Remove(Control)	Entfernt das angegebene Serversteuerelement aus dem ControlCollection-Objekt des übergeordneten Serversteuerelements (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

Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um
OfType<TResult>(IEnumerable)	Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)	Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Konvertiert einen IEnumerable in einen IQueryable.

Gilt für:

Freigeben über