EmptyControlCollection EmptyControlCollection EmptyControlCollection EmptyControlCollection Class

Definition

Bietet Standardunterstützung für eine ControlCollection-Auflistung, die immer leer ist.Provides standard support for a ControlCollection collection that is always empty.

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
EmptyControlCollectionEmptyControlCollectionEmptyControlCollectionEmptyControlCollection

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.This class is used when you want to define a custom control that does not allow child controls.

Konstruktoren

EmptyControlCollection(Control) EmptyControlCollection(Control) EmptyControlCollection(Control) EmptyControlCollection(Control)

Initialisiert eine neue Instanz der EmptyControlCollection-Klasse.Initializes a new instance of the EmptyControlCollection class.

Methoden

Add(Control) Add(Control) Add(Control) Add(Control)

Verweigert das Hinzufügen des angegebenen Control-Objekts zu der Auflistung.Denies the addition of the specified Control object to the collection.

AddAt(Int32, Control) AddAt(Int32, Control) AddAt(Int32, Control) AddAt(Int32, Control)

Verweigert das Hinzufügen des angegebenen Control-Objekts an der angegebenen Indexposition der Auflistung.Denies the addition of the specified Control object to the collection, at the specified index position.

Clear() Clear() Clear() Clear()

Entfernt sämtliche Steuerelemente aus dem ControlCollection-Objekt des aktuellen Serversteuerelements.Removes all controls from the current server control's ControlCollection object.

(Inherited from ControlCollection)
Contains(Control) Contains(Control) Contains(Control) Contains(Control)

Bestimmt, ob sich das angegebene Serversteuerelement im ControlCollection-Objekt des übergeordneten Serversteuerelements befindetDetermines whether the specified server control is in the parent server control's ControlCollection object.

(Inherited from ControlCollection)
CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Kopiert die im ControlCollection-Objekt gespeicherten untergeordneten Steuerelemente in ein Array-Objekt. Dabei wird mit der angegebenen Indexposition im Array begonnen.Copies the child controls stored in the ControlCollection object to an Array object, beginning at the specified index location in the Array.

(Inherited from ControlCollection)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Ruft einen Enumerator ab, der das ControlCollection-Objekt durchlaufen kannRetrieves an enumerator that can iterate through the ControlCollection object.

(Inherited from ControlCollection)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
IndexOf(Control) IndexOf(Control) IndexOf(Control) IndexOf(Control)

Ruft den Index eines angegebenen Control-Objekts in der Auflistung abRetrieves the index of a specified Control object in the collection.

(Inherited from ControlCollection)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(Control) Remove(Control) Remove(Control) Remove(Control)

Entfernt das angegebene Serversteuerelement aus dem ControlCollection-Objekt des übergeordneten ServersteuerelementsRemoves the specified server control from the parent server control's ControlCollection object.

(Inherited from ControlCollection)
RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Entfernt ein untergeordnetes Steuerelement an der angegebenen Indexposition aus dem ControlCollection-ObjektRemoves a child control, at the specified index location, from the ControlCollection object.

(Inherited from ControlCollection)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Eigenschaften

Count Count Count Count

Ruft die Anzahl der Serversteuerelemente im ControlCollection-Objekt für das angegebene ASP.NET-Serversteuerelement ab.Gets the number of server controls in the ControlCollection object for the specified ASP.NET server control.

(Inherited from ControlCollection)
IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Ruft einen Wert ab, der angibt, ob das ControlCollection-Objekt schreibgeschützt ist.Gets a value indicating whether the ControlCollection object is read-only.

(Inherited from ControlCollection)
IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Ruft einen Wert ab, der angibt, ob das ControlCollection-Objekt synchronisiert ist.Gets a value indicating whether the ControlCollection object is synchronized.

(Inherited from ControlCollection)
Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ruft im ControlCollection-Objekt an der angegebenen Indexposition einen Verweis auf das Serversteuerelement abGets a reference to the server control at the specified index location in the ControlCollection object.

(Inherited from ControlCollection)
Owner Owner Owner Owner

Ruft das ASP.NET-Serversteuerelement ab, zu dem das ControlCollection-Objekt gehörtGets the ASP.NET server control to which the ControlCollection object belongs.

(Inherited from ControlCollection)
SyncRoot SyncRoot SyncRoot SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf die Steuerelementauflistung synchronisiert werden kannGets an object that can be used to synchronize access to the collection of controls.

(Inherited from ControlCollection)

Erweiterungsmethoden

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.Converts an IEnumerable to an IQueryable.

Gilt für: