Cách làm việc với các bảng trong .NET

Bước 1: Cài đặt gói

Aspose.Words FOSS cho .NET chưa công bố gói NuGet – hãy xây dựng thư viện từ mã nguồn thay thế. Sao chép https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git, sau đó biên dịch Aspose.Words.sln ở cấu hình Release với SDK .NET và tham chiếu tới assembly Aspose.Words kết quả từ dự án của bạn. Thư viện nhắm tới .NET Standard 2.0, vì vậy nó chạy trên .NET Framework 4.6.2+ và .NET 6/8/10.

Bước 2: Nhập các lớp cần thiết

Thêm một chỉ thị using Aspose.Words; cho các lớp tài liệu cốt lõi (Document, DocumentBuilder), và một chỉ thị using Aspose.Words.Tables; cho các lớp đặc thù bảng mà hướng dẫn này đề cập – Table, Row, Cell, CellFormat, RowFormat, PreferredWidth, và các enum liên quan.

Bước 3: Xây dựng một Bảng Mới với DocumentBuilder

Tạo một Document và một DocumentBuilder được liên kết với nó, sau đó gọi DocumentBuilder.StartTable() để bắt đầu một bảng tại con trỏ. Đối với mỗi ô trong một hàng, gọi DocumentBuilder.InsertCell(), rồi đóng hàng bằng DocumentBuilder.EndRow(). Lặp lại cho số hàng cần thiết của bảng, và đóng toàn bộ bảng bằng DocumentBuilder.EndTable(). Mỗi StartTable() cần một EndTable() tương ứng, và mỗi hàng cần một EndRow() tương ứng, nếu không trạng thái nội bộ của builder — và cây tài liệu kết quả — sẽ bị sai cấu trúc.

Bước 4: Định dạng các ô và hàng khi bạn xây dựng

Đặt DocumentBuilder.CellFormat và DocumentBuilder.RowFormat trước khi gọi InsertCell() hoặc EndRow() để áp dụng định dạng cho các ô và hàng mà builder sắp tạo — hai thuộc tính này hoạt động như một mẫu cho nội dung mới, không phải là thay đổi hồi tố cho các ô đã chèn. CellFormat tiết lộ Borders, Shading, Width, WrapText, FitText, HorizontalMerge, VerticalMerge, VerticalAlignment, PreferredWidth, và bốn thuộc tính đệm (LeftPadding, RightPadding, TopPadding, BottomPadding), tất cả có thể được đặt cùng một lúc bằng SetPaddings(). RowFormat tiết lộ Borders, Height, HeightRule, AllowBreakAcrossPages, và HeadingFormat. Gọi CellFormat.ClearFormatting() hoặc RowFormat.ClearFormatting() để đặt lại bất kỳ một trong số chúng về mặc định trước khi đặt giá trị mới cho hàng hoặc ô tiếp theo.

Bước 5: Đặt Bố Cục Toàn Bảng và AutoFit

Khi bảng đã tồn tại, đặt các thuộc tính bố cục trực tiếp trên đối tượng Table: Alignment (TableAlignment), Bidi, LeftIndent, PreferredWidth, Style, StyleIdentifier, StyleName, StyleOptions (TableStyleOptions), và TextWrapping. Gọi Table.SetBorders() để áp dụng một kiểu viền, độ rộng và màu sắc cho toàn bộ bảng, hoặc Table.SetBorder() để đặt một phía riêng; ClearBorders() và ClearShading() đặt lại chúng. Table.AutoFit(AutoFitBehavior) thay đổi kích thước bảng và các ô của nó theo hành vi đã chọn — gọi lại sau bất kỳ chỉnh sửa cấu trúc nào, vì nó chỉ phản ánh trạng thái của bảng tại thời điểm chạy, không liên tục.

Bước 6: Đặt Chiều Rộng Ưu Tiên và Chiều Rộng Ô

Tạo các giá trị chiều rộng bằng các phương thức factory tĩnh PreferredWidth.FromPercent() cho một bố cục thích ứng với chiều rộng trang có sẵn, hoặc PreferredWidth.FromPoints() cho chiều rộng cố định; PreferredWidthType báo cáo loại giá trị nào (Auto, Percent, hoặc Points) một PreferredWidth cụ thể chứa. Gán kết quả cho Table.PreferredWidth cho toàn bộ bảng hoặc CellFormat.PreferredWidth cho một ô.

Bước 7: Gộp Ô

Đánh dấu các ô là đã gộp bằng cách đặt CellFormat.HorizontalMerge hoặc CellFormat.VerticalMerge (cả hai được nhập CellMerge) trên các ô cần tham gia vào việc gộp. Nếu các ô chỉ được làm cho trông như đã gộp bằng cách khớp độ rộng thay vì được gắn cờ rõ ràng, hãy gọi Table.ConvertToHorizontallyMergedCells() để chuyển bố cục trực quan đó thành các ô có trạng thái CellMerge thực tế. CellVerticalAlignment kiểm soát cách nội dung được căn dọc trong một ô, độc lập với bất kỳ việc gộp nào.

Bước 8: Đọc Các Bảng Từ Tài Liệu Hiện Có

Để làm việc với các bảng đã có trong tài liệu đã tải, đọc Body.Tables (hoặc thuộc tính Tables trên bất kỳ Story nào khác) — một TableCollection — thay vì tạo mới. Table.Rows trả về một RowCollection và Row.Cells trả về một CellCollection; cả ba kiểu bộ sưu tập đều hỗ trợ Add(), Insert(), Remove(), RemoveAt(), Contains(), và IndexOf() cho các chỉnh sửa bằng chương trình. Sau khi xóa các hàng hoặc ô, gọi Table.EnsureMinimum(), Row.EnsureMinimum(), hoặc Cell.EnsureMinimum() để nút giữ cấu trúc hợp lệ tối thiểu mà Word mong đợi — một hàng trống, một ô trống, hoặc một đoạn văn trống, tương ứng.