Classe Control (System.Web.UI)

Si tratta della classe primaria dalla quale si deriva quando si sviluppano controlli server ASP.NET personalizzati. Control non dispone di alcuna funzionalità specifica dell'interfaccia utente. Se si modifica un controllo che non dispone di un'interfaccia utente o che combina altri controlli che utilizzano le rispettive interfacce utente, derivarlo da Control. Se si desidera creare un controllo senza interfaccia utente, derivare da WebControl o da qualsiasi controllo dello spazio dei nomi System.Web.UI.WebControls che costituisca un punto di partenza appropriato per il controllo personalizzato.

La classe Control è la classe base per tutti i controlli server ASP.NET, inclusi i controlli personalizzati, i controlli utente e le pagine. Le pagine ASP.NET sono istanze della classe Page, che eredita dalla classe Control e che gestisce le richieste di file con estensione aspx.

La classe Control può essere utilizzata direttamente o indirettamente come parte dell'interfaccia utente di un'applicazione Web e, come tale, deve essere analizzata per garantire che vengano seguite le procedure ottimali per la scrittura di codice sicuro e la sicurezza delle applicazioni.

Per informazioni generali su questi argomenti, vedere Cenni preliminari sui pericoli di sicurezza a cui sono esposte le applicazioni Web, Procedure consigliate per i criteri di sicurezza e Concetti principali sulla sicurezza. Per informazioni più specifiche, vedere Protezione dei controlli standard, Procedura: visualizzare messaggi di errore protetti, Procedura: proteggere da attacchi tramite script in un'applicazione Web applicando alle stringhe la codifica HTML e Introduction to the Validation Controls.

Nell'esempio seguente viene descritto un controllo server personalizzato che deriva dalla classe Control. La classe InnerContent esegue l'override del metodo Control.Render, verifica se la classe dispone di controlli figli nella pagina e determina se il primo controllo figlio è un controllo Literal. Se entrambe le condizioni sono soddisfatte, il metodo sottoposto a override scrive la stringa HTML <H2>Messaggio:, il contenuto del controllo e un tag di chiusura </H2> nella pagina del Web Form.

Nota sulla sicurezza
L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET convalidano l'input utente in modo che non includa script o elementi HTML. Per ulteriori informazioni, vedere Cenni preliminari sugli attacchi tramite script.

Option Explicit
Option Strict

Imports System
Imports System.Web
Imports System.Web.UI
Imports Microsoft.VisualBasic

Namespace SimpleControlSamples
    Public Class InnerContent
        Inherits Control
        <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="Execution")> _
        Protected Overrides Sub Render(output As HtmlTextWriter)

            If HasControls() And TypeOf Controls(0) Is LiteralControl Then
                output.Write("<H2>Your message : ")
                Controls(0).RenderControl(output)
                output.Write("</H2>")
            End If
        End Sub 'Render
    End Class 'InnerContent
End Namespace 'SimpleControlSamples

using System;
using System.Web;
using System.Web.UI;

namespace SimpleControlSamples {

    public class InnerContent : Control {
	[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="Execution")] 
       protected override void Render(HtmlTextWriter output) {

           if ( (HasControls()) && (Controls[0] is LiteralControl) ) {
               output.Write("<H2>Your message : ");
               Controls[0].RenderControl(output);
               output.Write("</H2>");
           }
       }
    }    
}
   

.NET Framework

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

Riferimenti

Altre risorse