proprietàScopo
Questa proprietà rappresenta lo stato di cancellato di un documento.
Sintassi
Documento.Deleted := True
Quando letta
Restituisce True se il documento è in stato cancellato, False altrimenti. Questa proprietà si riferisce al documento in sè e non all'intera gerarchia documentale. Ad esempio se un documento "padre" è in stato cancellato, leggendo questa proprietà sui documenti "figli" essa può tornare False perchè il documento figlio può anche non essere in stato cancellato. E' possibile usare la funzione IsDeleted per ottenere lo stato relativo alla struttura documentale di cui questo documento è parte.
Quando scritta
Imposta lo stato di cancellato del documento. Se il documento non ha gli eventi congelati, come spiegato nella proprietà FreezeEvents, allora la modifica di questa proprietà attiva la richiesta di un lock sul documento, inoltre dopo la modifica della proprietà viene notificato al documento l'evento di OnDeleting.
Esempio di codice
// Cancella il corriere selezionato (se c'è)
// *****************************************
public void Corrieri.Cancella()
{
Corriere c = null // Il corriere da cancellare
//
// Prendo il corriere selezionato nel pannello
c := Corriere.Document
//
if NOT(c IS Null Object)
{
// e lo cancello (può essere ancora recuperato)
c.Deleted := True
}
}
- I documenti in stato cancellato possono essere ancora recuperati fino al momento del salvataggio sul database, impostando la proprietà Deleted a False, oppure usando la procedura ResetOriginal sulla collection o sul documento di cui questo documento è parte.
- Per salvare correttamente un documento in stato cancellato con sotto-documenti non cancellati è oppurtuno creare sul database relazioni (foreign keys) di tipo Delete Cascade.
- Effettuando cicli For-Each su collection che contengono documenti cancellati, essi non vengono enumerati. E' possibile modificare questo comportamento tramite la proprietà ShowDeleted della collection.
Ultima modifica: 23/03/2021 / Validità: da 6.5.2680