Esporta (0) Stampa
Espandi tutto

Metodo Control.ClearChildState

Nota: questo metodo è stato introdotto con .NET Framework versione 2.0.

Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server.

Spazio dei nomi: System.Web.UI
Assembly: System.Web (in system.web.dll)

protected void ClearChildState ()
protected void ClearChildState ()
protected function ClearChildState ()

Il metodo ClearChildState cancella tutte le informazioni sullo stato di visualizzazione e sullo stato del controllo per i controlli figlio. Equivale a chiamare i metodi ClearChildViewState e ClearChildControlState.

Quando si ricreano controlli figlio di un oggetto Control, utilizzare il metodo ClearChildState per cancellare lo stato del controllo figlio, in modo che non venga applicato ai nuovi controlli inavvertitamente.

Nell'esempio di codice riportato di seguito viene descritto come eseguire l'override del metodo OnDataBinding per un controllo basato su modelli e con associazione a dati. Se l'origine dati a cui è associato il controllo è popolata, l'insieme ControlCollection del controllo viene svuotato tramite il metodo Clear e si utilizza il metodo ClearChildState per rimuovere eventuali informazioni sullo stato salvate per i controlli figlio.

// Override to create the repeated items from the DataSource.
protected override void OnDataBinding(EventArgs e) {
    base.OnDataBinding(e);

    if (DataSource != null) {
        // Clear any existing child controls.
        Controls.Clear();
        // Clear any previous state for the existing child controls.
        ClearChildState();

        // Iterate over the DataSource, creating a new item for each data item.
        IEnumerator dataEnum = DataSource.GetEnumerator();
        int i = 0;
        while(dataEnum.MoveNext()) {

            // Create an item.
            RepeaterItem item = new RepeaterItem(i, dataEnum.Current);
            // Initialize the item from the template.
            ItemTemplate.InstantiateIn(item);
            // Add the item to the ControlCollection.
            Controls.Add(item);

            i++;
        }

        // Prevent child controls from being created again.
        ChildControlsCreated = true;
        // Store the number of items created in view state for postback scenarios.
        ViewState["NumItems"] = i;
    }
}

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework

Supportato in: 2.0

Aggiunte alla community

AGGIUNGI
Mostra:
© 2015 Microsoft