EmptyControlCollection Classe

Référence

Définition

Espace de noms:: System.Web.UI

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Assure la prise en charge standard de la collection ControlCollection toujours vide.

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

Héritage: Object

ControlCollection
EmptyControlCollection

Exemples


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

Remarques

Cette classe est utilisée lorsque vous souhaitez définir un contrôle personnalisé qui n’autorise pas les contrôles enfants.

Constructeurs

EmptyControlCollection(Control)

Initialise une nouvelle instance de la classe EmptyControlCollection.

Propriétés

Count	Obtient le nombre de contrôles serveur dans l'objet ControlCollection pour le contrôle serveur ASP.NET spécifié. (Hérité de ControlCollection)
IsReadOnly	Obtient une valeur indiquant si l’objet ControlCollection est en lecture seule. (Hérité de ControlCollection)
IsSynchronized	Obtient une valeur indiquant si l'objet ControlCollection est synchronisé. (Hérité de ControlCollection)
Item[Int32]	Obtient une référence au contrôle serveur à l'emplacement d'index spécifié dans l'objet ControlCollection. (Hérité de ControlCollection)
Owner	Obtient le contrôle serveur ASP.NET auquel l'objet ControlCollection appartient. (Hérité de ControlCollection)
SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l'accès à la collection de contrôles. (Hérité de ControlCollection)

Méthodes

Add(Control)	Refuse l'ajout de l'objet Control spécifié à la collection.
AddAt(Int32, Control)	Refuse l'ajout de l'objet Control spécifié à la collection, à la position d'index spécifiée.
Clear()	Supprime tous les contrôles de l'objet ControlCollection du contrôle serveur en cours. (Hérité de ControlCollection)
Contains(Control)	Détermine si le contrôle serveur spécifié se trouve dans l'objet ControlCollection du contrôle serveur parent. (Hérité de ControlCollection)
CopyTo(Array, Int32)	Copie les contrôles enfants stockés dans l'objet ControlCollection vers un objet Array, en commençant à l'emplacement d'index spécifié dans Array. (Hérité de ControlCollection)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetEnumerator()	Récupère un énumérateur qui peut effectuer une itération au sein de l'objet ControlCollection. (Hérité de ControlCollection)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IndexOf(Control)	Récupère l'index d'un objet Control spécifié dans la collection. (Hérité de ControlCollection)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Remove(Control)	Supprime le contrôle serveur spécifié de l'objet ControlCollection du contrôle serveur parent. (Hérité de ControlCollection)
RemoveAt(Int32)	Supprime un contrôle enfant de l'objet ControlCollection, à l'emplacement d'index spécifié. (Hérité de ControlCollection)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Méthodes d’extension

Cast<TResult>(IEnumerable)	Effectue un cast des éléments d'un IEnumerable vers le type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d'un IEnumerable en fonction du type spécifié.
AsParallel(IEnumerable)	Active la parallélisation d'une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.

S’applique à

Partager via