Procedura: creare proprietà personalizzabili in un controllo Web part

Aggiornamento: novembre 2007

Una delle funzionalità principali dell'insieme di controlli Web part consiste nella personalizzazione dei controlli in una pagina. Ciò consente all'utente finale di impostare valori per le proprietà che vengono mantenuti ogni volta che l'utente visualizza la pagina.

Gli sviluppatori della pagina possono attivare la personalizzazione applicando l'attributo Personalizable a una proprietà pubblica di un controllo Web part. Il controllo può essere un controllo personalizzato ereditato da WebPart, un controllo utente o qualsiasi altro controllo in cui è possibile creare una proprietà, a condizione che si trovi all'interno di un'area WebPartZone e che ci sia un controllo WebPartManager in un punto della pagina.

Nota:

Ai fini dell'esecuzione della procedura, è necessario disporre di un sito Web ASP.NET in grado di identificare i singoli utenti. Se è già stato configurato un sito con tali caratteristiche, utilizzarlo. In caso contrario, per informazioni dettagliate sulla creazione di una directory virtuale, vedere Procedura: creare e configurare directory virtuali in IIS 5.0 e 6.0. È inoltre necessario disporre di un provider di personalizzazioni e di un database configurati. La personalizzazione di Web part è attivata per impostazione predefinita; se è installato Microsoft SQL Server Express (SSE), non è necessaria alcuna configurazione. SSE è disponibile con Microsoft Visual Studio 2005 come parte facoltativa dell'installazione oppure può essere scaricato gratuitamente dal sito Web Microsoft. In caso contrario, se si utilizza la versione completa di SQL Server, vedere Creazione e configurazione del database dei servizi dell'applicazione per SQL Server, oppure per un database non SQL o altra soluzione di archiviazione vedere Implementazione di un provider di appartenenze.

Per attivare la personalizzazione in un controllo

1. Inserire il controllo da personalizzare in un'area WebPartZone di una pagina Web part ASP.NET. La pagina deve contenere un controllo WebPartManager affinché i controlli Web part funzionino. Per ulteriori informazioni, vedere Procedura dettagliata: creazione di una pagina Web part.

2. All'inizio del blocco di codice in cui è definita la proprietà che si desidera personalizzare, aggiungere l'attributo Personalizable, come illustrato nell'esempio seguente.

   <Personalizable()>
   Property SampleProperty() As String
     Get…
     Set…
   End Property
   

   [Personalizable]
   Public string SampleProperty
   {
     Get{…}
     Set{…}
   }
   

Vedere anche

Concetti

Cenni preliminari sulla personalizzazione di Web part

Requisiti per l'utilizzo della personalizzazione di Web part

Riferimenti

System.Web.UI.WebControls.WebParts

Personalizable

Altre risorse

Controlli Web part ASP.NET

Personalizzazione di Web part