proceduraScopo
Questa procedura permette di impostare la dimensione della collection senza effettivamente caricare i documenti in essa contenuti, il caricamento verrà effettuato OnDemand, scatenando l'evento di OnMissingDocument. E' quindi la procedura che inizia il processo di caricamento ritardato della collection.
Sintassi
Collection.SetSize(numero elementi, document provider)
Argomenti
| Numero Elementi | E' il numero di documenti che conterrà la collection |
| Document Provider | E' un oggetto di tipo documento a cui la collection notificherà l'evento OnMissingDocument per ottenere il caricamento della parte di collection desiderata |
Esempio di codice
// ****************************************************************************
// Evento notificato al documento prima di caricare una collection del suo tipo
// ****************************************************************************
event Divisa.BeforeLoadCollection(
IDDocument Parent // E' il documento padre che ha ch...
IDCollection Collection of IDDocument // E' la collection da caricare.
inout boolean Skip // Parametro di output booleano. S...
)
{
// Non carico la collection dal database
Skip := True
//
// La collection conterrà 500 documenti, ma verranno caricati solo ondemand
Collection.SetSize(C500, This())
}
// Evento notificato al documento prima di caricare una collection del suo tipo
// ****************************************************************************
event Divisa.BeforeLoadCollection(
IDDocument Parent // E' il documento padre che ha ch...
IDCollection Collection of IDDocument // E' la collection da caricare.
inout boolean Skip // Parametro di output booleano. S...
)
{
// Non carico la collection dal database
Skip := True
//
// La collection conterrà 500 documenti, ma verranno caricati solo ondemand
Collection.SetSize(C500, This())
}
- Questa procedura può essere utilizzata nell'evento di BeforeLoadCollection o GlobalBeforeLoadCollection per inizializzare il caricamento ritardato della collection.
- Internamente la collection contiene dei puntatori a null invece che i documenti. E' importante implementare l'evento OnMissingDocument, altrimenti la collection non verrà mai caricata.
Ultima modifica: 25/10/2016 / Validità: da 8.5.3800