วิธีทำงานกับตารางใน .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.

คู่มือแบบขั้นตอนต่อขั้นตอน

ขั้นตอนที่ 1: ติดตั้งแพ็กเกจ

dotnet add package Aspose.Slides.Foss

ขั้นตอนที่ 2: สร้างหรือเปิดงานนำเสนอ

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

ขั้นตอนที่ 3: กำหนดความกว้างของคอลัมน์และความสูงของแถว

ตารางต้องการความกว้างของคอลัมน์และความสูงของแถวที่ระบุเป็นจุด (1 point = 1/72 นิ้ว) สไลด์มาตรฐานมีความกว้าง 720 จุดและความสูง 540 จุด.

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

ขั้นตอนที่ 4: เพิ่มตาราง

slide.Shapes.AddTable(x, y, columnWidths, rowHeights) สร้างตารางที่ตำแหน่ง (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);

ขั้นตอนที่ 5: ตั้งค่าข้อความในเซลล์

เข้าถึงเซลล์ผ่าน table.Rows[rowIndex][colIndex] และกำหนดข้อความผ่าน .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);

ขั้นตอนที่ 6: จัดรูปแบบข้อความในเซลล์หัวตาราง

ใช้การจัดรูปแบบตัวหนากับเซลล์หัวตารางโดยใช้ 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);
    }
}

ตัวอย่างทำงานครบถ้วน

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

ปัญหาทั่วไปและวิธีแก้

IndexOutOfRangeException เมื่อเข้าถึง table.Rows[row][col]

ดัชนีแถวและคอลัมน์เริ่มจากศูนย์ หากคุณกำหนด rowHeights โดยมี 3 องค์ประกอบ ดัชนีแถวที่ใช้ได้คือ 0, 1, 2.

ข้อความในเซลล์ไม่แสดงในไฟล์ที่บันทึก

กำหนดค่าตลอดผ่าน .TextFrame.Text, ไม่ใช่ผ่าน .Text โดยตรงบนอ็อบเจกต์เซลล์:

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

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

Table position is off the slide: ตำแหน่งของตารางอยู่นอกสไลด์

ตรวจสอบว่า x + sum(colWidths) <= 720 และ y + sum(rowHeights) <= 540 สำหรับสไลด์มาตรฐาน.

คำถามที่พบบ่อย

Can I merge table cells?: ฉันสามารถรวมเซลล์ตารางได้หรือไม่?

การรวมเซลล์ไม่รองรับในรุ่นนี้.

ฉันสามารถกำหนดสีพื้นหลังทั่วทั้งตารางได้หรือไม่?

ใช้การจัดรูปแบบการเติมสีกับแต่ละเซลล์แยกกัน:

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

ฉันสามารถตั้งค่าสไตล์เส้นขอบของเซลล์ได้หรือไม่?

คุณสมบัติขอบของเซลล์สามารถเข้าถึงได้ผ่าน cell.CellFormat.BorderLeft, BorderTop, BorderRight, และ BorderBottom คุณสมบัติ. ดูเอกสารอ้างอิง API เพื่อรับรายการเต็มของแอตทริบิวต์การจัดรูปแบบขอบ.