Workbook classe

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

Il tipo Workbook espone i seguenti membri:

Costruttori

Costruttore	Descrizione
`__init__(self)`	Inizializza una nuova istanza della classe `Workbook`.
`__init__(self, file_format_type)`	Inizializza una nuova istanza della classe `Workbook`.
`__init__(self, file)`	Inizializza una nuova istanza della classe `Workbook` e apre un file.
`__init__(self, stream)`	Inizializza una nuova istanza della classe `Workbook` e apre un flusso.
`__init__(self, file, load_options)`	Inizializza una nuova istanza della classe `Workbook` e apre un file.
`__init__(self, stream, load_options)`	Inizializza una nuova istanza della classe `Workbook` e apre il flusso.

Proprietà

Proprietà	Descrizione
settings	Rappresenta le impostazioni della cartella di lavoro.
worksheets	Ottiene la raccolta `WorksheetCollection` nel foglio di calcolo.
is_licensed	Indica se la licenza è impostata.
colors	Restituisce i colori nella tavolozza del foglio di calcolo.
count_of_styles_in_pool	Ottiene il numero di stili nel pool di stili.
default_style	Ottiene o imposta l’oggetto predefinito `Style` della cartella di lavoro.
is_digitally_signed	Indica se questo foglio di calcolo è firmato digitalmente.
is_workbook_protected_with_password	Indica se la struttura o la finestra è protetta da password.
vba_project	Ottiene `Workbook.vba_project` in un foglio di calcolo.
has_macro	Indica se questo foglio di calcolo contiene macro/VBA.
has_revisions	Ottiene se la cartella di lavoro contiene modifiche tracciate
file_name	Ottiene e imposta il nome del file corrente.
cells_data_table_factory	Ottiene la fabbrica per la creazione di ICellsDataTable da oggetti personalizzati
data_sorter	Ottiene un oggetto DataSorter per ordinare i dati.
theme	Ottiene il nome del tema.
built_in_document_properties	Restituisce una raccolta `DocumentProperty` che rappresenta tutte le proprietà del documento integrate nel foglio di calcolo.
custom_document_properties	Restituisce una raccolta `DocumentProperty` che rappresenta tutte le proprietà personalizzate del documento del foglio di calcolo.
file_format	Ottiene e imposta il formato del file.
has_custom_function	Rileva se è presente una funzione personalizzata utilizzata in questa cartella di lavoro, come nella formula della cella, nei nomi definiti…
content_type_properties	Ottiene l’elenco di `ContentTypeProperty` oggetti nella cartella di lavoro.
custom_xml_parts	Rappresenta una parte di archiviazione dati XML personalizzata (dati XML personalizzati all’interno di un pacchetto).
data_mashup	Ottiene dati mashup.
ribbon_xml	Ottiene e imposta il file XML che definisce l’interfaccia utente della barra multifunzione.
absolute_path	Ottiene e imposta il percorso assoluto del file.
data_connections	Ottiene la raccolta ExternalConnection.
data_model	Ottiene il modello di dati nella cartella di lavoro.

Metodi

Metodo	Descrizione
`save(self, file_name, save_format)`	Salva la cartella di lavoro sul disco.
`save(self, file_name)`	Salvare la cartella di lavoro sul disco.
`save(self, file_name, save_options)`	Salva la cartella di lavoro sul disco.
`save(self, stream, save_format)`	Salva la cartella di lavoro nel flusso.
`save(self, stream, save_options)`	Salva la cartella di lavoro nel flusso.
`create_style(self)`	Crea un nuovo stile.
`create_style(self, clone_default_style)`	Crea un nuovo stile.
`replace(self, place_holder, new_value)`	Sostituisce il valore di una cella con una nuova stringa.
`replace(self, place_holder, new_value)`	Sostituisce il valore di una cella con un nuovo numero intero.
`replace(self, place_holder, new_value)`	Sostituisce il valore di una cella con un nuovo valore double.
`replace(self, place_holder, new_values, is_vertical)`	Sostituisce il valore di una cella con una nuova matrice di stringhe.
`replace(self, place_holder, new_values, is_vertical)`	Sostituisce i valori delle celle con un array di interi.
`replace(self, place_holder, new_values, is_vertical)`	Sostituisce i valori delle celle con un array double.
`replace(self, bool_value, new_value)`	Sostituisce i valori delle celle con nuovi dati.
`replace(self, int_value, new_value)`	Sostituisce i valori delle celle con nuovi dati.
`replace(self, place_holder, new_value, options)`	Sostituisce il valore di una cella con una nuova stringa.
`copy(self, source, copy_options)`	Copia un altro oggetto Workbook.
`copy(self, source)`	Copia i dati da un oggetto Workbook di origine.
`calculate_formula(self)`	Calcola il risultato delle formule.
`calculate_formula(self, ignore_error)`	Calcola il risultato delle formule.
`calculate_formula(self, options)`	Calcolo delle formule in questa cartella di lavoro.
`refresh_dynamic_array_formulas(self, calculate)`	Aggiorna le formule di matrice dinamica (si riversa in un nuovo intervallo di celle adiacenti in base ai dati correnti) Le altre formule nella cartella di lavoro non verranno calcolate in modo ricorsivo, anche se utilizzate da formule di matrice dinamica.
`refresh_dynamic_array_formulas(self, calculate, copts)`	Aggiorna le formule di matrice dinamica (si riversa in un nuovo intervallo di celle adiacenti in base ai dati correnti)
`import_xml(self, url, sheet_name, row, col)`	Importa/aggiorna un file di dati XML nella cartella di lavoro.
`import_xml(self, stream, sheet_name, row, col)`	Importa/aggiorna un file di dati XML nella cartella di lavoro.
`export_xml(self, map_name, path)`	Esporta i dati XML collegati dalla mappa XML specificata.
`export_xml(self, map_name, stream)`	Esportare dati XML.
`parse_formulas(self, ignore_error)`	Analizza tutte le formule che non sono state analizzate quando sono state caricate dal file modello o impostate in una cella.
`start_access_cache(self, opts)`	Avvia la sessione che utilizza le cache per accedere ai dati.
`close_access_cache(self, opts)`	Chiude la sessione che utilizza le cache per accedere ai dati.
`remove_unused_styles(self)`	Rimuovere tutti gli stili non utilizzati.
`create_builtin_style(self, type)`	Crea uno stile incorporato in base al tipo specificato.
`create_cells_color(self)`	Crea un oggetto `CellsColor`.
`combine(self, second_workbook)`	Combina un altro oggetto Workbook.
`get_style_in_pool(self, index)`	Ottiene lo stile nel pool di stile. Tutti gli stili presenti nella cartella di lavoro verranno raccolti in un pool. Nelle celle è presente solo un semplice indice di riferimento.
`get_fonts(self)`	Ottiene tutti i font nel pool di stili.
`get_named_style(self, name)`	Ottiene lo stile denominato nel pool di stili.
`merge_named_styles(self, source)`	Unisce gli stili denominati dall’altro file Excel.
`change_palette(self, color, index)`	Cambia la tavolozza del foglio di calcolo nell’indice specificato.
`is_color_in_palette(self, color)`	Controlla se un colore è presente nella tavolozza del foglio di calcolo.
`get_matching_color(self, raw_color)`	Trova il colore più corrispondente nella tavolozza corrente.
`set_encryption_options(self, encryption_type, key_length)`	Imposta le opzioni di crittografia.
`protect(self, protection_type, password)`	Protegge una cartella di lavoro.
`protect_shared_workbook(self, password)`	Protegge una cartella di lavoro condivisa.
`unprotect(self, password)`	Rimuove la protezione da una cartella di lavoro.
`unprotect_shared_workbook(self, password)`	Rimuove la protezione da una cartella di lavoro condivisa.
`remove_macro(self)`	Rimuove VBA/macro da questo foglio di calcolo.
`remove_digital_signature(self)`	Rimuove la firma digitale da questo foglio di calcolo.
`accept_all_revisions(self)`	Accetta tutte le modifiche tracciate nella cartella di lavoro.
`remove_external_links(self)`	Rimuove tutti i collegamenti esterni nella cartella di lavoro.
`get_theme_color(self, type)`	Ottiene il colore del tema.
`set_theme_color(self, type, color)`	Imposta il colore del tema
`custom_theme(self, theme_name, colors)`	Il tema è la dogana.
`copy_theme(self, source)`	Copia il tema da un’altra cartella di lavoro.
`has_exernal_links(self)`	Indica se la cartella di lavoro contiene collegamenti esterni ad altre origini dati.
`update_custom_function_definition(self, definition)`	Aggiorna la definizione delle funzioni personalizzate.
`update_linked_data_source(self, external_workbooks)`	Se questa cartella di lavoro contiene collegamenti esterni ad altre fonti di dati, Aspose.Cells tenterà di recuperare i dati più recenti dalle fonti indicate.
`set_digital_signature(self, digital_signature_collection)`	Imposta la firma digitale su un file di foglio di calcolo (Excel 2007 e versioni successive).
`add_digital_signature(self, digital_signature_collection)`	Aggiunge una firma digitale a un file di foglio di calcolo OOXML (Excel 2007 e versioni successive).
`get_digital_signature(self)`	Ottiene la firma digitale dal file.
`remove_personal_information(self)`	Rimuove le informazioni personali.
`close(self)`	Dispose() viene ignorato dal wrapper dal protocollo Python

Osservazioni

La classe Workbook indica un foglio di calcolo Excel. Ogni foglio di calcolo può contenere più fogli di lavoro. La caratteristica di base del corso è quella di aprire e salvare file Excel nativi. Il corso offre alcune funzionalità avanzate, come la copia di dati da altre cartelle di lavoro, la combinazione di due cartelle di lavoro, la conversione di Excel in PDF, il rendering di Excel in formato immagine e la protezione del foglio di calcolo Excel.

Esempio

L’esempio seguente carica un codice Workbook da un file Excel denominato designer.xls e rende invisibili le barre di scorrimento orizzontale e verticale. Quindi sostituisce due valori stringa rispettivamente con un valore intero e un valore stringa all’interno del foglio di calcolo e infine salva la cartella di lavoro come file Excel xlsx.

from aspose.cells import Workbook

# Open a designer file
designerFile = "designer.xls"
workbook = Workbook(designerFile)
# Set scroll bars
workbook.settings.is_h_scroll_bar_visible = False
workbook.settings.is_v_scroll_bar_visible = False
# Replace the placeholder string with new values
newInt = 100
workbook.replace("OldInt", newInt)
newString = "Hello!"
workbook.replace("OldString", newString)
workbook.save("result.xlsx")

Guarda anche

WarningInfo classe WorkbookDesigner classe