Jak pracować z tablicami w .NET

Aspose.Slides FOSS for .NET supports creating tables on slides with configurable column widths and row heights. This guide shows how to add a table, populate it with data, and apply basic text formatting to cells.

Przewodnik krok po kroku

Krok 1: Instalacja pakietu

aspose-slides-foss/slides is not yet published — build from source until it ships. See the project README for build instructions.

Krok 2: Tworzenie lub otwarcie prezentacji

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];
// ... add table ...
prs.Save("table.pptx", SaveFormat.Pptx);

Krok 3: Określ szerokość kolumny i wysokość rzędu

Tabele wymagają wyraźnych szerokości kolumny i wysokości kolejek w punktach (1 punkt = 1/72 cala). standardowy ślizg wynosi 720 punktów szeroki i 540 punktami wysoki.

var colWidths = new double[] { 200.0, 150.0, 150.0 };   // 3 columns
var rowHeights = new double[] { 45.0, 40.0, 40.0 };     // 3 rows

Krok 4: Dodaj tabelę

slide.Shapes.AddTable(x, y, columnWidths, rowHeights) Tworzenie tabeli w pozycji (x, y):

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];

var colWidths = new double[] { 200.0, 150.0, 150.0 };
var rowHeights = new double[] { 45.0, 40.0, 40.0 };
var table = slide.Shapes.AddTable(50, 100, colWidths, rowHeights);

prs.Save("table.pptx", SaveFormat.Pptx);

Krok 5: Zestaw tekstów komórkowych

Komórki dostępu poprzez table.Rows[rowIndex][colIndex] i przekazuje tekst poprzez .TextFrame.Text:

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];

var colWidths = new double[] { 200.0, 150.0, 150.0 };
var rowHeights = new double[] { 45.0, 40.0, 40.0 };
var table = slide.Shapes.AddTable(50, 100, colWidths, rowHeights);

// Header row (row 0)
string[] headers = { "Product", "Units Sold", "Revenue" };
for (int col = 0; col < headers.Length; col++)
    table.Rows[0][col].TextFrame.Text = headers[col];

// Data rows
string[][] data = {
    new[] { "Widget A", "1,200", "$24,000" },
    new[] { "Widget B", "850", "$17,000" },
};
for (int rowIdx = 0; rowIdx < data.Length; rowIdx++)
    for (int col = 0; col < data[rowIdx].Length; col++)
        table.Rows[rowIdx + 1][col].TextFrame.Text = data[rowIdx][col];

prs.Save("sales-table.pptx", SaveFormat.Pptx);

Krok 6: Formatowanie tekstu Header Cell

Stosuj odważne formatyzowanie do komórek głównych za pomocą PortionFormat:

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;

for (int col = 0; col < headers.Length; col++)
{
    var cell = table.Rows[0][col];
    var portions = cell.TextFrame.Paragraphs[0].Portions;
    if (portions.Count > 0)
    {
        var fmt = portions[0].PortionFormat;
        fmt.FontBold = NullableBool.True;
        fmt.FillFormat.FillType = FillType.Solid;
        fmt.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 255, 255, 255);
    }
}

Pełny przykład pracy

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;
using Aspose.Slides.Foss.Export;

string[][] dataRows = {
    new[] { "North", "$1.2M", "+8%" },
    new[] { "South", "$0.9M", "+4%" },
    new[] { "East",  "$1.5M", "+12%" },
    new[] { "West",  "$0.7M", "+2%" },
};
string[] headers = { "Region", "Revenue", "Growth" };

using var prs = new Presentation();
var slide = prs.Slides[0];

var colWidths = new double[] { 180.0, 140.0, 120.0 };
var rowHeights = new double[dataRows.Length + 1];
rowHeights[0] = 45.0;
for (int i = 1; i < rowHeights.Length; i++) rowHeights[i] = 38.0;

var table = slide.Shapes.AddTable(60, 80, colWidths, rowHeights);

// Header row
for (int col = 0; col < headers.Length; col++)
{
    var cell = table.Rows[0][col];
    cell.TextFrame.Text = headers[col];
    if (cell.TextFrame.Paragraphs[0].Portions.Count > 0)
    {
        var fmt = cell.TextFrame.Paragraphs[0].Portions[0].PortionFormat;
        fmt.FontBold = NullableBool.True;
    }
}

// Data rows
for (int rowIdx = 0; rowIdx < dataRows.Length; rowIdx++)
    for (int col = 0; col < dataRows[rowIdx].Length; col++)
        table.Rows[rowIdx + 1][col].TextFrame.Text = dataRows[rowIdx][col];

prs.Save("regional-revenue.pptx", SaveFormat.Pptx);
Console.WriteLine("Saved regional-revenue.pptx");

Wspólne problemy i rozwiązania

IndexOutOfRangeException Kiedy dostęp table.Rows[row][col]

Wskaźniki rzędu i kolumny są oparte na zerie. jeśli zdefiniujesz rowHeights z 3 elementami, ważny wskaźnik kolejności wynosi 0, 1, 2.

Tekst komórkowy nie pojawia się w zapisanych plikach.

Zawsze przypisywane przez .TextFrame.Text,Nie przez .Text w celu uzyskania obiektów komórkowych:

// Correct
table.Rows[0][0].TextFrame.Text = "Header";

// Wrong: will not compile or silent failure
// table.Rows[0][0].Text = "Header";

Pozycja stołu jest poza śladem

Sprawdź to x + sum(colWidths) <= 720 i y + sum(rowHeights) <= 540 Dla standardowego slide.

Często zadawane pytania

Czy mogę połączyć komórki stołowe?

Tak, użyj Table.MergeCells(ICell cell1, ICell cell2, bool allowSplitting) do połączenia dwóch komórek sąsiadujących. ustawienie allowSplitting do false Aby zapobiec ponownemu rozpadowi komórki. przykład:

// Merge cell (row 0, col 0) with cell (row 0, col 1)
var cell1 = table.Rows[0][0];
var cell2 = table.Rows[0][1];
table.MergeCells(cell1, cell2, false);

Czy mogę zastosować kolor tła w tabeli?

Wymień formatyzację do każdej komórki:

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;

for (int row = 0; row < table.Rows.Count; row++)
    for (int col = 0; col < table.Rows[row].Count; col++)
    {
        var cell = table.Rows[row][col];
        cell.CellFormat.FillFormat.FillType = FillType.Solid;
        cell.CellFormat.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 240, 248, 255);
    }

Czy mogę ustawić styl granic komórkowych?

Właściwości graniczne komórki są dostępne przez cell.CellFormat.BorderLeft, BorderTop, BorderRight,i BorderBottom Odwołuje się do odniesienia API dla pełnej listy atrybutów formatu granicznego.