Introduction

Aspose.Cells FOSS for .NET is a pure managed-code, MIT-licensed library for reading, writing, Excel ile manipüle etmek .xlsx Microsoft Office bağımlılığı olmadan çalışma kitapları. yüklü olarak O’nun Aspose.Cells_FOSS NuGet paket, herhangi bir .NET projesine entegre edilir - konsol uygulamaları, web API, arka plan çalışanları ve sunucusuz fonksiyonlar.

Bu gönderi, herkese açık API’nin özellik‑özellik bir yürütmesini sunar, nelerin mümkün olduğunu ve her bir yeteneğin C# kodundan nasıl çağrılacağını gösterir.

Özellik Genel Bakışı

Çalışma Kitabı ve Çalışma Sayfası Yaşam Döngüsü

Her operasyon için giriş noktası ise Workbook Sınıf: Birini bir çerçeve ile yapın. new Workbook(),ya da mevcut bir yükü yüklemek için .xlsx ile new Workbook(filePath) veya new Workbook(stream).Navigasyon sayfaları üzerinden Workbook.Worksheets,Set için Worksheet.Name ve Worksheet.VisibilityType,ve devam ederken, Workbook.Save().• Kayıp dosyalar için, geçin a LoadOptions Örnek ile TryRepairPackage = true ve 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);
}

Hücre Verileri ve Formüller

  • Hücreler için değerler yazın Cell.PutValue() - Ücretli kabul string, int, double, decimal, bool,ve DateTime.Değerleri geri okuyun Cell.Value, Cell.StringValue,ve Cell.Formula.Excel formülünü kullanarak Cell.Formula • Formül: formül çubuğu Kurtarma ve yeniden yükleme döngüsü üzerinde kalır.

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);


### Hücre Stili

Apply `Style` yazı tipi, doldurma, sınırlar, sayı biçimi ve uyum kontrolü için nesneler. Mevcut tarzı yeniden kullanın `Cell.GetStyle()`,değiştirin, sonra da yapın `Cell.SetStyle()`.Arka planlar için, set `Style.Pattern = FillPattern.Solid` ve A'ya atama `Color` için `Style.ForegroundColor`.Kullanım `Cells.Merge()` hücre rengi ile yapılır.

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}");

Koşullu Biçimlendirme

Şartlı biçimlendirme kurallarını hücre aralığına bağlayın ConditionalFormattingCollection. Destek Kuralları FormatConditionType.CellValue, Expression, ColorScale, DataBar,ve IconSet.Kullanım OperatorType (İşletme Yönetmeliği’ne göre)Between, Equal, GreaterThan, vb. ) A’ya göre Style öncelikler belirlenir ve önlemleri belirlemek ve Hatta durdurma eylemleri kural olarak yapılır.

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”);


### Veri Doğrulama

Kullanılan hücrelere giriş kısıtlamaları ekleyin `Worksheet.Validations`.Desteklenen Validasyon Türleri dahil olmak üzere `ValidationType.List`, `Decimal`, `Custom`, ve daha fazlası. giriş prompts ayarlayın (`InputTitle`, `InputMessage`• Hatalı mesajlar (`ErrorTitle`, `ErrorMessage`, `ValidationAlertType`• Kullanım `CellArea.CreateCellArea()` Doğrulama alanı ve `Validation.AddArea()` Ek bir kural için uygulama.

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");

Sayfa Ayarı ve Yazdırma Seçenekleri

Yazdırma layout ile yapılandırın Worksheet.PageSetup.Yorumlar için tıklayınız (LeftMarginInch, RightMarginInch, TopMarginInch, BottomMarginInch), Orientation, PaperSize,ve ölçeği, baskı alanı, başlık satırları ve sütunları, başlılar ve ayaklar, ve sayfa boşlukları. tüm ayarlar hayatta kalır Bir kurtarma yükü yuvarlak yolculuk.

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”);


### Çalışma Sayfası Ayarları ve Koruma

Kontrolü ile ekranlı `Worksheet.ShowGridlines`, `ShowRowColumnHeaders`, `ShowZeros`, `RightToLeft`, `Zoom`,ve `TabColor`.• Kargo ile korumak `Worksheet.Protect()` -Kıvılcımlı bir yapılandırma `Protection` bayraklar (`Objects`, `FormatCells`, `InsertRows`, `AutoFilter`, `SelectLockedCells`* Sıralama yüksekliği, sütun genişliği ve gizli satırlar / süturlar yönetin. Birleşik Bölgeler `Cells.Rows`, `Cells.Columns`,ve `Cells.Merge()`.

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");

Köprüler ve Adlandırılmış Aralıklar

Dış, iç ve mailto: Hyperlink üzerinden HyperlinkCollection.Add().Setleri Hyperlink.TextToDisplay ve Hyperlink.ScreenTip Kullanıcı tarafından görülebilen etiketler için. tanımlama adı Çalışma kitabı veya sayfa aralığı kullanarak DefinedNameCollection.Add() - Adı Rango olarak hizmet eder istikrarlı formül anchors ve grafik dosya yeniden yükleme hayatta kalan veri kaynakları.

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);


---

## Hızlı Başlangıç

```bash
dotnet add package 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”);


---

## Desteklenen Formatlar

| Format | Extension   | Read | Write |
| ------ | ----------- | ---- | ----- |
| Xlsx   | .xlsx için  | ✓    | ✓     |
| Auto   | ( Çeşitli ) | ✓    | —     |

---

## Açık Kaynak & Lisans

Aspose.Cells FOSS for .NET is published under the MIT license and distributed via NuGet as `Aspose.Cells_FOSS`.Açık kaynaklı ve ticari projeler için de uygundur.

---

## Başlamaya başlar

- [Başlamaya başlar](https://docs.aspose.org/cells/net/getting-started/)
- [Geliştirici Kılavuzu](https://docs.aspose.org/cells/net/developer-guide/)
- [KB Makaleleri](https://kb.aspose.org/cells/net/)
- [API Referansı](https://reference.aspose.org/cells/net/)