Aspose.Cells Software Livre e de Código Aberto

Perguntas Frequentes

Como instalo o Aspose.Cells FOSS?

Instale‑o a partir do PyPI usando pip:

pip install aspose-cells-foss>=26.3.1

Após a instalação, verifique se funciona:

from aspose.cells_foss import Workbook
wb = Workbook()
print("Installation successful")

Como leio o valor de uma célula?

Use a propriedade .value; é uma propriedade, não um método. Não adicione parênteses.

from aspose.cells_foss import Workbook

wb = Workbook("input.xlsx")
ws = wb.worksheets[0]

# Correct: .value is a property (no parentheses)
val = ws.cells["A1"].value
print(val)

# Also correct: access by row, column index (1-based)
val2 = ws.cells[1, 1].value
print(val2)

Como escrevo um valor ou fórmula em uma célula?

Atribua a .value ou .formula diretamente. Ambos são propriedades, não métodos.

from aspose.cells_foss import Workbook

wb = Workbook()
ws = wb.worksheets[0]

# Write a value
ws.cells["A1"].value = "Product"
ws.cells["B1"].value = 100

# Write a formula
ws.cells["C1"].formula = "=SUM(A1:B1)"

wb.save("output.xlsx")

Alternativamente, use cells.get_cell_by_name(address).put_value(value) quando você tem um endereço de célula de string:

ws.cells.get_cell_by_name("A1").put_value("Product")
ws.cells.get_cell_by_name("B1").put_value(100)

O Aspose.Cells FOSS suporta exportação de PDF?

Não. A exportação para PDF não está disponível na edição FOSS. Os formatos de salvamento suportados são:

XLSX: wb.save("output.xlsx")
CSV: wb.save("output.csv")
Markdown: wb.save_as_markdown("output.md")

Como faço para carregar um arquivo CSV?

Use a função de conveniência load_csv_workbook():

from aspose.cells_foss import load_csv_workbook

wb = load_csv_workbook("data.csv")
ws = wb.worksheets[0]
val = ws.cells["A1"].value

Para mais controle, use CSVHandler com CSVLoadOptions:

from aspose.cells_foss import Workbook, CSVHandler, CSVLoadOptions

opts = CSVLoadOptions()
wb = Workbook()
CSVHandler.load_csv(wb, "data.csv", opts)
ws = wb.worksheets[0]

Como adiciono um gráfico?

Use um dos métodos add_* em ws.charts. Cada método recebe argumentos posicionais para a caixa delimitadora do gráfico: top_row, left_col, bottom_row, right_col.

from aspose.cells_foss import Workbook

wb = Workbook()
ws = wb.worksheets[0]

# Add data
ws.cells["A1"].value = "Month"
ws.cells["B1"].value = "Sales"
ws.cells["A2"].value = "Jan"
ws.cells["B2"].value = 1200
ws.cells["A3"].value = "Feb"
ws.cells["B3"].value = 1500

# Add a bar chart (top_row, left_col, bottom_row, right_col)
chart = ws.charts.add_bar(5, 0, 20, 8)
chart.title = "Monthly Sales"
chart.n_series.add("B2:B3", is_vertical=True)

wb.save("output.xlsx")

Por que `cell.value()` gera um TypeError?

Porque .value é uma propriedade, não um método. Chamar cell.value() tenta chamar o valor retornado como uma função, o que gera TypeError. Sempre use atribuição ou acesso direto ao atributo:

# Wrong: raises TypeError
cell.value("Hello")
cell.formula("=SUM(A1:A5)")
val = cell.value()

# Correct
cell.value = "Hello"
cell.formula = "=SUM(A1:A5)"
val = cell.value

Quais formatos de arquivo podem ser carregados?

Formato	Extensão	Como carregar
Excel 2007–2019	.xlsx	`Workbook("file.xlsx")`
Excel 97–2003	.xls	Não suportado. Apenas o formato XLSX é suportado para leitura e gravação. Arquivos XLS/BIFF não são suportados.
CSV	.csv	`load_csv_workbook("file.csv")`

Veja Também

Aspose.Cells FOSS está licenciado sob a Licença MIT. Revise os termos completos da licença no arquivo LICENSE. Para instalação e uso básico, veja o README e o diretório de exemplos.

Perguntas Frequentes