Workbook

Workbook class

Rappresenta un oggetto radice per creare un foglio di calcolo Excel.

public class Workbook : IDisposable

Costruttori

NomeDescrizione
Workbook()Inizializza una nuova istanza diWorkbook classe.
Workbook(FileFormatType)Inizializza una nuova istanza diWorkbook classe.
Workbook(Stream)Inizializza una nuova istanza diWorkbook classe e apri uno stream.
Workbook(string)Inizializza una nuova istanza diWorkbook classe e apri un file.
Workbook(Stream, LoadOptions)Inizializza una nuova istanza diWorkbook classe e apri stream.
Workbook(string, LoadOptions)Inizializza una nuova istanza diWorkbook classe e apri un file.

Proprietà

NomeDescrizione
AbsolutePath { get; set; }Ottiene e imposta il percorso assoluto del file.
BuiltInDocumentProperties { get; }Restituisce aDocumentPropertyraccolta che rappresenta tutte le proprietà del documento integrate nel foglio di calcolo.
CellsDataTableFactory { get; }Ottiene la factory per la creazione di ICellsDataTable da oggetti personalizzati
Colors { get; }Restituisce i colori nella tavolozza per il foglio di calcolo.
ContentTypeProperties { get; }Ottiene l’elenco diContentTypeProperty oggetti nella cartella di lavoro.
CountOfStylesInPool { get; }Ottiene il numero degli stili nel pool di stili.
CustomDocumentProperties { get; }Restituisce aDocumentProperty raccolta che rappresenta tutte le proprietà del documento personalizzato del foglio di calcolo.
CustomXmlParts { get; }Rappresenta una parte di archiviazione dati XML personalizzata (dati XML personalizzati all’interno di un pacchetto).
DataConnections { get; }Ottiene ilExternalConnection raccolta.
DataMashup { get; }Ottiene dati mashup.
DataSorter { get; }Ottiene un oggetto DataSorter per ordinare i dati.
DefaultStyle { get; set; }Ottiene o imposta il valore predefinitoStyle oggetto della cartella di lavoro.
FileFormat { get; set; }Ottiene e imposta il formato del file.
FileName { get; set; }Ottiene e imposta il nome del file corrente.
HasMacro { get; }Indica se questo foglio di calcolo contiene macro/VBA.
HasRevisions { get; }Ottiene se la cartella di lavoro contiene modifiche rilevate
InterruptMonitor { get; set; }Ottiene e imposta il monitor di interruzione.
IsDigitallySigned { get; }Indica se questo foglio di calcolo è firmato digitalmente.
IsLicensed { get; }Indica se la licenza è impostata.
IsWorkbookProtectedWithPassword { get; }Indica se la struttura o la finestra sono protette con password.
RibbonXml { get; set; }Ottiene e imposta il file XML che definisce l’interfaccia utente della barra multifunzione.
Settings { get; }Rappresenta le impostazioni della cartella di lavoro.
Theme { get; }Ottiene il nome del tema.
VbaProject { get; }Ottiene ilVbaProject in un foglio di calcolo.
Worksheets { get; }Ottiene ilWorksheetCollection raccolta nel foglio di calcolo.

Metodi

NomeDescrizione
AcceptAllRevisions()Accetta tutte le modifiche rilevate nella cartella di lavoro.
AddDigitalSignature(DigitalSignatureCollection)Aggiunge la firma digitale a un file di foglio di calcolo OOXML (Excel2007 e versioni successive).
CalculateFormula()Calcola il risultato delle formule.
CalculateFormula(bool)Calcola il risultato delle formule.
CalculateFormula(CalculationOptions)Calcolo delle formule in questa cartella di lavoro.
ChangePalette(Color, int)Modifica la tavolozza per il foglio di calcolo nell’indice specificato.
CloseAccessCache(AccessCacheOptions)Chiude la sessione che utilizza le cache per accedere ai dati.
Combine(Workbook)Combina un altro oggetto cartella di lavoro.
Copy(Workbook)Copia i dati da un oggetto cartella di lavoro di origine.
Copy(Workbook, CopyOptions)Copia i dati da un oggetto cartella di lavoro di origine.
CopyTheme(Workbook)Copia il tema da un’altra cartella di lavoro.
CreateBuiltinStyle(BuiltinStyleType)Crea uno stile integrato in base al tipo specificato.
CreateCellsColor()Crea aCellsColor oggetto.
CreateStyle()Crea un nuovo stile.
CustomTheme(string, Color[])Personalizza il tema.
Dispose()Esegue attività definite dall’applicazione associate alla liberazione, rilascio o ripristino di risorse non gestite.
ExportXml(string, Stream)Esporta dati XML.
ExportXml(string, string)Esporta dati XML collegati dalla mappa XML specificata.
GetDigitalSignature()Ottiene la firma digitale dal file.
GetFonts()Ottiene tutti i caratteri nel pool di stili.
GetMatchingColor(Color)Trova il colore più adatto nella tavolozza corrente.
GetNamedStyle(string)Ottiene lo stile denominato nel pool di stili.
GetStyleInPool(int)Ottiene lo stile nel pool di stili. Tutti gli stili nella cartella di lavoro verranno raccolti in un pool. Nelle celle è presente solo un semplice indice di riferimento.
GetThemeColor(ThemeColorType)Ottiene il colore del tema.
ImportXml(Stream, string, int, int)Importa/aggiorna un file di dati XML nella cartella di lavoro.
ImportXml(string, string, int, int)Importa/aggiorna un file di dati XML nella cartella di lavoro.
IsColorInPalette(Color)Verifica se nella tavolozza del foglio di calcolo è presente un colore.
ParseFormulas(bool)Analizza tutte le formule che non sono state analizzate quando sono state caricate dal file modello o impostate su una cella.
Protect(ProtectionType, string)Protegge una cartella di lavoro.
ProtectSharedWorkbook(string)Protegge una cartella di lavoro condivisa.
RefreshDynamicArrayFormulas(bool)Aggiorna le formule di matrice dinamica (si riversa in un nuovo intervallo di celle adiacenti in base ai dati correnti)
RemoveDigitalSignature()Rimuove la firma digitale da questo foglio di lavoro.
RemoveMacro()Rimuove VBA/macro da questo foglio di calcolo.
RemovePersonalInformation()Rimuove le informazioni personali.
RemoveUnusedStyles()Rimuovi tutti gli stili non utilizzati.
Replace(bool, object)Sostituisce i valori delle celle con nuovi dati.
Replace(int, object)Sostituisce i valori delle celle con nuovi dati.
Replace(string, DataTable)Sostituisce i valori delle celle con i dati di aDataTable .
Replace(string, double)Sostituisce il valore di una cella con un nuovo double.
Replace(string, int)Sostituisce il valore di una cella con un nuovo intero.
Replace(string, string)Sostituisce il valore di una cella con una nuova stringa.
Replace(string, double[], bool)Sostituisce i valori delle celle con un doppio array.
Replace(string, int[], bool)Sostituisce i valori delle celle con un array intero.
Replace(string, string, ReplaceOptions)Sostituisce il valore di una cella con una nuova stringa.
Replace(string, string[], bool)Sostituisce il valore di una cella con un nuovo array di stringhe.
Save(string)Salva la cartella di lavoro sul disco.
Save(Stream, SaveFormat)Salva la cartella di lavoro nello stream.
Save(Stream, SaveOptions)Salva la cartella di lavoro nello stream.
Save(string, SaveFormat)Salva la cartella di lavoro sul disco.
Save(string, SaveOptions)Salva la cartella di lavoro sul disco.
Save(HttpResponse, string, ContentDisposition, SaveOptions)Crea il foglio di calcolo dei risultati e lo trasferisce al client, quindi lo apre nel browser o nella cartella di lavoro MS.
Save(HttpResponse, string, ContentDisposition, SaveOptions, bool)Crea il foglio di calcolo dei risultati e lo trasferisce al client, quindi lo apre nel browser o nella cartella di lavoro MS.
SaveToStream()Salva il file Excel in un oggetto MemoryStream e lo restituisce.
SetDigitalSignature(DigitalSignatureCollection)Imposta la firma digitale su un file di foglio di calcolo (Excel2007 e versioni successive).
SetEncryptionOptions(EncryptionType, int)Imposta opzioni di crittografia.
SetThemeColor(ThemeColorType, Color)Imposta il colore del tema
StartAccessCache(AccessCacheOptions)Avvia la sessione che utilizza le cache per accedere ai dati.
Unprotect(string)Annulla la protezione di una cartella di lavoro.
UnprotectSharedWorkbook(string)Annulla la protezione di una cartella di lavoro condivisa.
UpdateLinkedDataSource(Workbook[])Se questa cartella di lavoro contiene collegamenti esterni ad altre origini dati, Aspose.Cells tenterà di recuperare i dati più recenti.

Osservazioni

La classe Workbook denota un foglio di calcolo Excel. Ogni foglio di calcolo può contenere più fogli di lavoro. La funzionalità di base della classe è aprire e salvare file excel nativi. La classe ha alcune funzionalità avanzate come la copia di dati da altre cartelle di lavoro, la combinazione di due cartelle di lavoro e la protezione del foglio di calcolo Excel.

Esempi

L’esempio seguente carica una cartella di lavoro da un file denominato designer.xls e rende invisibili le barre di scorrimento orizzontale e verticale per la cartella di lavoro. Quindi sostituisce due valori di stringa rispettivamente con un valore intero e un valore di stringa all’interno del foglio di calcolo e infine invia il file aggiornato al browser del client.

[C#]

//Apri un file di progettazione
string designerFile = "designer.xls";
Workbook workbook = new Workbook(designerFile);

//Imposta le barre di scorrimento
workbook.Settings.IsHScrollBarVisible = false;
workbook.Settings.IsVScrollBarVisible = false;

//Sostituisci la stringa segnaposto con nuovi valori
int newInt = 100;
workbook.Replace("OldInt", newInt);

string newString = "Hello!";
workbook.Replace("OldString", newString);
workbook.Save("result.xls");

[Visual Basic]

'Apri un file di progettazione
Dim designerFile as String = "\designer.xls"
Dim workbook as Workbook = new Workbook(designerFile)

'Imposta le barre di scorrimento
workbook.IsHScrollBarVisible = False
workbook.IsVScrollBarVisible = False

'Sostituisci la stringa segnaposto con nuovi valori
Dim newInt as Integer = 100
workbook.Replace("OldInt", newInt)

Dim newString as String = "Hello!"
workbook.Replace("OldString", newString)
workbook.Save("result.xls")    

Guarda anche