Simplex FORM

Simplex FORM è una libreria di classi a supporto delle funzionalità che stanno alla base di tutte le maschere applicative che è possibile costruire con il framework Simplex.

Le classi sono:

1. SimplexBreadCrumb: è la classe a supporto del controllo web che mostra l’attuale albero di navigazione tra le maschere di un’applicazione. Un oggetto della classe rappresenta un ramo di navigazione percorso.
2. SimplexBreadCrumbs: Classe che rappresenta una collezione di oggetti di classe SimplexBreadCrumb, cioè l’albero di navigazione vero e proprio.
3.  SimplexForm: Classe base (o superclasse) dalla quale derivano tutte le maschere del framework Simplex. E’ una specializzazione della classe Page appositamente progettata per operare con gli oggetti delle classi della libreria simplex_ORM. Le informazioni gestite da una maschera derivata da SimplexForm possono risiedere o in un oggetto ORM (vedi simplex_ORM) se è prevista la loro conservazione in un database, o in un oggetto di classe SimplexFormDictionary qualora debbano semplicemente essere riutilizzate nella maschera stessa o in un’altra maschera. Nel paragrafo che segue verrà approfondita questa classe.
4. SimplexFormDictionary: Classe Dictionary (implementa IDictionary, IEnumerable) che colleziona triplette di informazioni (ID, Text, Type) che rappresentano rispettivamente l’ID di un controllo web, il valore della proprietà Text di tale controllo web ed una stringa che descrive il tipo di tale controllo web. Le triplette possono, ovviamente, essere usate anche per memorizzare qualsiasi tipo di informazione come in una normale collezione Dictionary.

Classe SimplexForm (Approfondimento)

La classe SimplexForm è la classe base per l’interfacciamento cioè è la classe base per il modello code-behind delle maschere del framework Simplex. Deriva da Page ma non è dotata di elementi grafici o di un proprio codice aspx. La classe supporta, attraverso la variabile di riferimento notevole TBL_UNDER_FORM, un oggetto di classe Simplex_ORM.Table e fornisce metodi per caricare lo stato dell’oggetto da un record di una tabella, mostrare a video nella maschera lo stato dell’oggetto, modificare lo stato dell’oggetto secondo quanto inserito nella maschera, salvare in un record di una tabella lo stato dell’oggetto.

TBL_UNDER_FORM è solo uno degli oggetti che formano lo stato di una maschera del framework Simplex. Il caricamento dello stato di una maschera avviene in fase di caricamento della maschera mediante il metodo preloadEnvironment() che è il primo metodo invocato dal gestore di evento Page_Load().

Nelle versioni più recenti è stata aggiunta la variabile notevole MAIN_UNDER_FORM che fa riferimento all’oggetto Simplex_ORM.Table supportato da un’eventuale maschera chiamante.

In Simplex lo stato di una maschera viene conservato principalmente in sessione. L’uso del ViewState per questo scopo è marginale (e desueto, cioè è presente solo nelle prime versioni di Simplex_FORM).  La Collection Session viene, quindi, usata per la conservazione dello stato e per il passaggio di informazioni ed oggetti tra la maschera chiamante e la maschera chiamata. Non solo. Ogni maschera di Simplex può accedere alle informazioni generali dell’applicazione attraverso un oggetto di classe GeneralApplication conservato in sessione. L’oggetto Session, quindi, è un oggetto fondamentale per il funzionamento di un’applicazione realizzata con Simplex.

SimplexForm non ha una propria visualizzazione e pertanto non è previsto che si possano aggiungere controlli web al suo interno. Per creare una maschera basata su SimplexForm è necessario usare una sua sottoclasse. La sottoclasse di derivazione diretta è GenericSpxForm, argomento di un dedicato articolo.

Storia delle Versioni

Versione	Data	Modifiche	Dll	Help	Sorgente
v.1.2.0.3	26/05/2018	– Corretto il BUG su getElement() – Cambiato il tipo restituito dal metodo “this[String p_Key]”.		Download