Share via


Informazioni sulla persistenza di ordini di colonne e righe ListObject

Aggiornamento: novembre 2007

Si applica a

Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati.

Tipo di progetto

  • Progetti a livello di documento

Versione Microsoft Office

  • Excel 2003

  • Excel 2007

Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

Quando si associano dati a un controllo ListObject aggiunto a un documento in fase di progettazione, Visual Studio Tools per Office tiene traccia dell'ordine di colonne e righe ogni volta che viene salvata la cartella di lavoro. Se un utente sposta colonne o righe del controllo ListObject in fase di esecuzione, il nuovo ordine verrà conservato alla successiva apertura della cartella di lavoro e il controllo ListObject verrà di nuovo associato all'origine dati.

Modalità di conservazione dell'ordine di colonne e righe

Quando si salva una cartella di lavoro contenente un controllo ListObject associato a dati, l'ordine di colonne e righe viene memorizzato nella cartella di lavoro all'interno di una proprietà personalizzata del documento.

Il nome della proprietà è determinato dall'utilizzo di un codice hash per il nome combinato della cartella di lavoro e dell'oggetto List. Il nome della proprietà personalizzata del documento per un controllo ListObject denominato List1 in Sheet1, ad esempio, potrebbe essere ___2387CEF09___0. Se la lunghezza del valore di questa proprietà supera i 255 caratteri, verrà creata un'altra proprietà personalizzata del documento con il successivo numero di sequenza, ad esempio ___2387CEF09___1, ___2387CEF09___2 e così via.

Il valore della proprietà personalizzata del documento contiene i nomi di colonne e i numeri di righe. Se ad esempio il controllo ListObject è composto di quattro righe e due colonne denominate LastName e FirstName, il valore della proprietà sarà FirstName*LastName%1*2*3*4. Se l'utente sposta la riga tre prima della riga due, il valore verrà cambiato in FirstName*LastName%1*3*2*4 quando verrà salvata la cartella di lavoro.

Alla successiva apertura della cartella di lavoro, il controllo ListObject legge le informazioni dalle proprietà del documento personalizzate e conserva l'ordine delle colonne e delle righe quando vengono caricati i dati.

Modalità di ripristino dell'ordine di colonne e righe

Se si desidera ripristinare l'ordine originale di colonne e righe del controllo ListObject, è possibile chiamare il metodo ResetPersistedBindingInformation. Questo metodo consente di rimuovere le proprietà del documento personalizzate relative all'ordine di colonne e righe del controllo ListObject specificato. Chiamare questo metodo dall'evento Shutdown del foglio di lavoro se non si desidera conservare l'ordine di colonne e righe del controllo ListObject.

Vedere anche

Attività

Procedura: mappare le colonne ListObject ai dati

Concetti

Controllo ListObject

Altre risorse

Controlli host di Excel