Scopo
Questa proprietà è True se il documento è già stato caricato dal database, False altrimenti. Essa viene utilizzata dal framework per gestire i casi di caricamento parziale di un documento dal database, per evitare di ricaricare le parti già caricate.
Se questa proprietà è True, significa che lo stato attuale del documento riflette i dati presenti nel database.
Se invece è False significa che non si è sicuri che il documento rifletta il contenuto del database e quindi sarebbe opportuno ricaricarlo per averne la certezza.
Sintassi
Documento.Loaded := False
Quando letta
Restituisce True se il documento è già stato caricato dal database, False altrimenti. E' interessante vedere anche la corrispondente proprietà Loaded della classe IDCollection.Quando scritta
Se impostata a True, significa che non sarà più necessario caricare il documento dal DB, se impostata a False indica che lo stato attuale del documento non riflette più i dati nel database e quindi dovrà essere effettivamente ricaricato alla prossima chiamata della funzione LoadFromDB.
La proprietà Loaded viene normalmente gestita dal framework durante il ciclo di caricamento del documento. Se il caricamento del documento dal database viene gestito da Visual Code è bene impostare questa proprietà a True per indicare che lo stato attuale del documento riflette i dati che sono nel database.
Esempio di codice
// Ricarica il corriere dal DB
// ***************************
public void Corriere2.BottoneRicarica()
{
Corriere c = null // Il corriere
//
// Prendo l'oggetto dal pannello
c := Corriere.Document
//
// Dico che voglio ricaricarlo
c.Loaded := False
//
// e lo faccio
c.LoadFromDB(??)
}
- Se il documento è in stato Inserted, esso non viene comunque caricato dal database anche se viene chiamata la funzione LoadFromDB.
- Se la proprietà Loaded è True, allora anche chiamando la funzione LoadFromDB il documento non viene ricaricato dal database, tuttavia potrebbero essere caricate le sue collection se non lo erano state in precedenza.
- La proprietà Loaded viene impostata a True subito prima di notificare l'evento di AfterLoad al documento.
- Può essere utile impostare la proprietà Loaded a False all'interno di un algoritmo se non si è sicuri che in quel momeno il documento sia aggiornato rispetto al database e lo si vuole ricaricare. A questo proposito si veda anche la funzione ResetLoaded che permette di indicare che un'intera gerarchia documentale deve essere ricaricata.
Ultima modifica: 22/09/2021 / Validità: da 6.5.2680