Introdução
Aspose.Cells FOSS for .NET is a pure managed-code, MIT-licensed library for reading, writing, e manipulação do Excel. .xlsx Livros de trabalho sem qualquer dependência do Microsoft Office. Instalado como a) O Aspose.Cells_FOSS Pacote NuGet, integra-se em qualquer projeto .NET aplicações de console, web APIs, trabalhadores de fundo e funções sem servidor.
Este post fornece uma passagem característica por característica da API pública, mostrando o que é possível e como invocar cada capacidade a partir do código C #.
Descrição geral das características
Livro e folha de trabalho Ciclo de vida
O ponto de entrada para cada operação é o Workbook Construir um a partir do zero com new Workbook(), ou carregam um sistema existente de .xlsx com: new Workbook(filePath) ou a) new Workbook(stream).Navegação através de folhas: Workbook.Worksheets, conjunto Worksheet.Name e a) Worksheet.VisibilityType, e persistir com Workbook.Save().Para arquivos danificados, passe um LoadOptions exemplo com TryRepairPackage = true e a) TryRepairXml = true.
using Aspose.Cells_FOSS;
var options = new LoadOptions
{
TryRepairPackage = true,
TryRepairXml = true,
};
try
{
_ = new Workbook("sample.xlsx", options);
}
catch (WorkbookLoadException exception)
{
Console.WriteLine(exception.Message);
}
Dados e fórmulas de células
Escrever valores em células com: Cell.PutValue() sobrecargas aceitas string, int, double, decimal, bool, e DateTime.Leia os valores de volta via: Cell.Value, Cell.StringValue, e Cell.Formula.Configurar fórmulas do Excel com o Cell.Formula propriedade; a sequência de fórmula é: preservada no save e sobrevive a um ciclo de recarga.
using Aspose.Cells_FOSS;
var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Cells["A1"].PutValue("Hello");
sheet.Cells["B1"].PutValue(123);
sheet.Cells["C1"].Formula = "=B1*2";
workbook.Save("hello.xlsx");
var loaded = new Workbook("hello.xlsx");
Console.WriteLine(loaded.Worksheets[0].Cells["C1"].Formula);
Console.WriteLine(loaded.Worksheets[0].Cells["C1"].StringValue);
Estilo de célula
Aplicar o pedido de autorização Style Objetos para controlar a fonte, o preenchimento, as bordas, os formatos de números e o alinhamento. Obter o estilo atual com: Cell.GetStyle(), mutá-lo, em seguida, cometer com Cell.SetStyle().Para preenchimento de fundo, definir: Style.Pattern = FillPattern.Solid e atribuir um Color a) para o Style.ForegroundColor.- Usar . Cells.Merge() para abranger as áreas de células.
using Aspose.Cells_FOSS;
var workbook = new Workbook();
var cell = workbook.Worksheets[0].Cells["A1"];
cell.PutValue("Styled");
var style = cell.GetStyle();
style.Font.Bold = true;
style.Pattern = FillPattern.Solid;
style.ForegroundColor = Color.FromArgb(255, 241, 196, 15);
cell.SetStyle(style);
Console.WriteLine($"{cell.StringValue} / Bold={cell.GetStyle().Font.Bold}");
Formatação condicional
Anexar regras de formatação condicional a intervalos de células via ConditionalFormattingCollection. Apoio às regras FormatConditionType.CellValue, Expression, ColorScale, DataBar, e IconSet.- Usar . OperatorType especificar os operadores de comparação (Between, Equal, GreaterThan, etc.), atribuir um Style para células correspondentes e configurar prioridade e comportamento de “stop-if-true” por regra.
using Aspose.Cells_FOSS;
var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
var cfCollection = sheet.ConditionalFormattings[sheet.ConditionalFormattings.Add()];
cfCollection.AddArea(CellArea.CreateCellArea("A1", "A10"));
var rule = cfCollection[cfCollection.AddCondition(
FormatConditionType.CellValue, OperatorType.Between, "3", "7")];
var style = rule.Style;
style.Pattern = FillPattern.Solid;
style.ForegroundColor = Color.FromArgb(255, 255, 199, 206);
style.Font.Bold = true;
rule.Style = style;
workbook.Save("conditional-formatting.xlsx");
Validação de dados
Adicionar restrições de entrada a células usando Worksheet.Validations.Tipos de validação suportados incluem: ValidationType.List, Decimal, Custom,Configurar instruções de entrada (InputTitle, InputMessage) e mensagens de erro (ErrorTitle, ErrorMessage, ValidationAlertType) Utilização CellArea.CreateCellArea() para definir a gama validada e Validation.AddArea() Aplicar uma regra a intervalos adicionais.
using Aspose.Cells_FOSS;
var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Name = "Validation Sheet";
var listIdx = sheet.Validations.Add(CellArea.CreateCellArea("A1", "A3"));
var listVal = sheet.Validations[listIdx];
listVal.Type = ValidationType.List;
listVal.Formula1 = "\"Open,Closed\"";
listVal.IgnoreBlank = true;
listVal.InCellDropDown = true;
listVal.ShowInput = true;
listVal.InputTitle = "Status";
listVal.InputMessage = "Pick a status";
listVal.ShowError = true;
listVal.ErrorTitle = "Invalid";
listVal.ErrorMessage = "Choose from the list";
workbook.Save("validations-sample.xlsx");
Opções de configuração e impressão da página
Configurar o layout de impressão via Worksheet.PageSetup.- Margens fixadas (LeftMarginInch, RightMarginInch, TopMarginInch, BottomMarginInch), Orientation, PaperSize, escala, área de impressão, linhas e colunas do título, cabeçalhos e pés de página e quebras de páginas. Todas as configurações sobrevivem uma viagem de ida e volta para poupar carga.
using Aspose.Cells_FOSS;
var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Name = "Print Sheet";
sheet.Cells["A1"].PutValue("Title");
var pageSetup = sheet.PageSetup;
pageSetup.Orientation = PageOrientationType.Landscape;
pageSetup.PaperSize = PaperSizeType.PaperA4;
pageSetup.PrintArea = "$A$1:$C$10";
pageSetup.PrintTitleRows = "$1:$2";
pageSetup.LeftHeader = "Left Header";
pageSetup.CenterFooter = "Center Footer";
pageSetup.PrintGridlines = true;
pageSetup.CenterHorizontally = true;
workbook.Save("page-setup-sample.xlsx");
Configuração e protecção da folha de trabalho
Display de controlo por folha com Worksheet.ShowGridlines, ShowRowColumnHeaders, ShowZeros, RightToLeft, Zoom, e TabColor.Proteger folhas com: Worksheet.Protect() e configurar granulado fino Protection bandeiras (Objects, FormatCells, InsertRows, AutoFilter, SelectLockedCells) Gerenciar a altura das linhas, largura da coluna, linhagens/colunas ocultas e Regiões fusionadas via: Cells.Rows, Cells.Columns, e Cells.Merge().
using Aspose.Cells_FOSS;
var workbook = new Workbook();
var layout = workbook.Worksheets[0];
layout.Name = "Layout";
layout.VisibilityType = VisibilityType.Hidden;
layout.TabColor = Color.FromArgb(255, 34, 68, 102);
layout.ShowGridlines = false;
layout.Zoom = 85;
layout.Protect();
layout.Protection.FormatCells = true;
layout.Protection.InsertRows = true;
layout.Cells["A1"].PutValue("Merged");
layout.Cells.Rows[1].Height = 22.5d;
layout.Cells.Columns[0].Width = 18.25d;
layout.Cells.Merge(0, 0, 2, 2);
workbook.Save("worksheet-settings-sample.xlsx");
Hiperlinks e intervalos com nomes
Adicionar externo, interno e mailto: hiperlinks via HyperlinkCollection.Add().- Está pronto . Hyperlink.TextToDisplay e a) Hyperlink.ScreenTip Para etiquetas visíveis ao utilizador. intervalos na área de trabalho do livro ou da folha utilizando: DefinedNameCollection.Add() os intervalos nomeados servem como Ancoradores de fórmulas estáveis e fontes de dados gráficos que sobrevivem à recarga do ficheiro.
using Aspose.Cells_FOSS;
var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Cells["A1"].PutValue("Docs");
var link = sheet.Hyperlinks[sheet.Hyperlinks.Add("A1", 1, 1, "https://example.com/docs")];
link.TextToDisplay = "Docs";
link.ScreenTip = "External documentation";
var name = workbook.DefinedNames[workbook.DefinedNames.Add("PrimaryRange", "='Sheet1'!$A$1:$D$5")];
name.Comment = "Primary data range";
workbook.Save("hyperlinks-names.xlsx");
Console.WriteLine("Hyperlinks: " + sheet.Hyperlinks.Count);
Console.WriteLine("Defined names: " + workbook.DefinedNames.Count);
Começo rápido
dotnet add package Aspose.Cells_FOSS
using Aspose.Cells_FOSS;
var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
sheet.Cells["A1"].PutValue("Hello");
sheet.Cells["B1"].PutValue(123);
sheet.Cells["C1"].Formula = "=B1*2";
workbook.Save("output.xlsx");
Formatos suportados
| Formatos de imagem | Extensão | Leia. | Escrever . |
|---|---|---|---|
| Xlsx | .xlsx | ✓ | ✓ |
| Automóvel . | (varios) | ✓ | — |
Open Source & Licenciamento
Aspose.Cells FOSS for .NET is published under the MIT license and distributed via NuGet as Aspose.Cells_FOSS.É adequado tanto para projetos de código aberto como comerciais.
