Procedura dettagliata: aggiunta di un attributo semplice a un controllo utente
Aggiornamento: novembre 2007
In questa procedura dettagliata viene illustrato come aggiungere un attributo a un controllo utente in un progetto per dispositivi. In particolare verrà aggiunto un attributo personalizzato che consente di rendere invisibile una proprietà del controllo in fase di progettazione. Aggiungere questa funzionalità a un progetto è utile per impedire che venga modificato il valore di una proprietà.
Il processo è simile a quello per desktop, ma nei progetti per dispositivi queste informazioni vengono archiviate in un file di metadati (XMTA) separato.
.gif "Nota") Nota: |
|---|
Nel computer in uso è possibile che vengano visualizzati nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per ulteriori informazioni vedere Impostazioni di Visual Studio. |
Questa procedura è stata scritta utilizzando Impostazioni di sviluppo di Visual C#.
Per creare la classe UserControl1
Scegliere Nuovo dal menu File, quindi scegliere Progetto.
Nel riquadro Tipi progetto espandere Visual C#, quindi fare clic su Smart Device.
Nel riquadro Modelli selezionare Progetto Smart Device.
Digitare MyControlLibrary nella casella Nome, quindi scegliere OK.
Nella finestra di dialogo Aggiungi nuovo progetto Smart Device selezionare Pocket PC 2003 nell'elenco a discesa Piattaforma di destinazione, selezionare .NET Compact Framework Versione 2.0 nell'elenco a discesa .NET Compact Framework, fare clic su Libreria di controlli nel riquadro Modelli, quindi scegliere OK.
Verrà visualizzata la finestra di progettazione con un riquadro che rappresenta la nuova classe del controllo utente.
Per aggiungere una proprietà
In Esplora soluzioni fare clic con il pulsante destro del mouse su UserControl1.cs, quindi scegliere Visualizza diagramma classi.
Verrà visualizzato un rettangolo arrotondato che rappresenta il diagramma classi.
Fare clic con il pulsante destro del mouse sul diagramma classi, quindi scegliere Dettagli classe.
Nella sezione Proprietà della finestra Dettagli classe, alla richiesta <aggiungi proprietà> digitare MyProperty.
Nella colonna Tipo sostituire int con string.
Fare clic con il pulsante destro del mouse sull'icona all'inizio della riga MyProperty, quindi scegliere Proprietà.
Per specificare un valore per la proprietà Attributi personalizzati, scegliere il pulsante con i puntini di sospensione (…) per aprire la finestra di dialogo Attributi personalizzati.
Digitare Browsable(false), quindi scegliere OK.
In Esplora soluzioni viene visualizzato un file XMTA di attributi Design-Time (DesignTimeAttributes.xmta) contenente l'attributo personalizzato.
Per compilare la libreria di controlli
In Esplora soluzioni fare clic con il pulsante destro del mouse su UserControl1.cs, quindi scegliere Visualizza codice.
Commentare la riga che genera l'eccezione System.NotImplementedException e inserire invece return ""; come azione get.
Scegliere Compila soluzione dal menu Compila MyControlLibrary.
Per verificare che MyProperty non venga visualizzata nel browser Proprietà
In Esplora soluzioni fare clic con il pulsante destro del mouse su MyControlLibrary, scegliere Aggiungi, quindi Nuovo elemento.
Nella finestra di dialogo Aggiungi nuovo elemento fare clic su Windows Form nel riquadro Categorie, quindi fare clic su Windows Form nel riquadro Modelli e infine scegliere Aggiungi.
Dalla Casella degli strumenti trascinare UserControl1 nel form.
Fare clic con il pulsante destro del mouse sull'immagine del controllo utente nel form, quindi scegliere Proprietà.
MyProperty non verrà visualizzata nel browser Proprietà.
In Esplora soluzioni fare doppio clic sul file XMTA e sostituire false con true.
Ripetere i passaggi per visualizzare la griglia Proprietà. Si noti che MyProperty viene ora visualizzata.
Vedere anche
Riferimenti
Visual Basic e Visual C# (procedure relative allo sviluppo per Smart Device)