EmptyControlCollection Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Fornisce il supporto standard per un insieme ControlCollection che è sempre vuoto.

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

Ereditarietà: Object

ControlCollection
EmptyControlCollection

Esempio


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

Commenti

Questa classe viene usata quando si vuole definire un controllo personalizzato che non consente controlli figlio.

Costruttori

EmptyControlCollection(Control)

Inizializza una nuova istanza della classe EmptyControlCollection.

Proprietà

Count	Ottiene il numero di controlli server nell'oggetto ControlCollection per il controllo server ASP.NET specificato. (Ereditato da ControlCollection)
IsReadOnly	Ottiene un valore che indica se l'oggetto ControlCollection è di sola lettura. (Ereditato da ControlCollection)
IsSynchronized	Ottiene un valore che indica se l'oggetto ControlCollection è sincronizzato. (Ereditato da ControlCollection)
Item[Int32]	Ottiene un riferimento al controllo server nella posizione di indice specificata nell'oggetto ControlCollection. (Ereditato da ControlCollection)
Owner	Ottiene il controllo server ASP.NET cui l'oggetto ControlCollection appartiene. (Ereditato da ControlCollection)
SyncRoot	Ottiene un oggetto che può essere utilizzato per sincronizzare l'accesso all'insieme dei controlli. (Ereditato da ControlCollection)

Metodi

Add(Control)	Non consente di aggiungere all'insieme l'oggetto Control specificato.
AddAt(Int32, Control)	Non consente di aggiungere l'oggetto Control specificato all'insieme nel percorso di indice indicata.
Clear()	Rimuove tutti i controlli dall'oggetto ControlCollection del controllo server corrente. (Ereditato da ControlCollection)
Contains(Control)	Stabilisce se il controllo server specificato è presente nell'oggetto ControlCollection del controllo server padre. (Ereditato da ControlCollection)
CopyTo(Array, Int32)	Copia i controlli figlio memorizzati nell'oggetto ControlCollection in un oggetto Array, a cominciare dalla posizione di indice specificata in Array. (Ereditato da ControlCollection)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetEnumerator()	Recupera un enumeratore che consente di scorrere l'oggetto ControlCollection. (Ereditato da ControlCollection)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IndexOf(Control)	Recupera l'indice di un oggetto Control specificato nell'insieme. (Ereditato da ControlCollection)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Remove(Control)	Rimuove il controllo server specificato dall'oggetto ControlCollection del controllo server padre. (Ereditato da ControlCollection)
RemoveAt(Int32)	Rimuove un controllo figlio, nella posizione di indice specificata, dall'oggetto ControlCollection. (Ereditato da ControlCollection)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Metodi di estensione

Cast<TResult>(IEnumerable)	Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.
OfType<TResult>(IEnumerable)	Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.
AsParallel(IEnumerable)	Consente la parallelizzazione di una query.
AsQueryable(IEnumerable)	Converte un oggetto IEnumerable in un oggetto IQueryable.

Si applica a

Condividi tramite