Jak pracować z tabelami w .NET

Krok 1: Zainstaluj pakiet

Aspose.Words FOSS dla .NET nie publikuje jeszcze pakietu NuGet – zamiast tego zbuduj bibliotekę ze źródeł. Sklonuj https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git, a następnie zbuduj Aspose.Words.sln w konfiguracji Release przy użyciu SDK .NET i odwołaj się do powstałego zestawu Aspose.Words w swoim projekcie. Biblioteka celuje w .NET Standard 2.0, więc działa na .NET Framework 4.6.2+ oraz .NET 6/8/10.

Krok 2: Zaimportuj wymagane klasy

Dodaj dyrektywę using Aspose.Words; dla podstawowych klas dokumentu (Document, DocumentBuilder) oraz dyrektywę using Aspose.Words.Tables; dla klas specyficznych dla tabel, które omawia ten przewodnik – Table, Row, Cell, CellFormat, RowFormat, PreferredWidth oraz powiązane wyliczenia.

Krok 3: Utwórz nową tabelę przy użyciu DocumentBuilder

Utwórz Document i DocumentBuilder powiązany z nim, a następnie wywołaj DocumentBuilder.StartTable(), aby rozpocząć tabelę w miejscu kursora. Dla każdej komórki w wierszu wywołaj DocumentBuilder.InsertCell(), a następnie zamknij wiersz przy pomocy DocumentBuilder.EndRow(). Powtarzaj tyle wierszy, ile potrzebuje tabela, i zamknij całą tabelę przy użyciu DocumentBuilder.EndTable(). Każdy StartTable() wymaga pasującego EndTable(), a każdy wiersz wymaga pasującego EndRow(), w przeciwnym razie wewnętrzny stan konstruktora — oraz powstałe drzewo dokumentu — stanie się niepoprawne.

Krok 4: Formatuj komórki i wiersze podczas budowania

Ustaw DocumentBuilder.CellFormat i DocumentBuilder.RowFormat przed wywołaniem InsertCell() lub EndRow(), aby zastosować formatowanie do komórek i wierszy, które konstruktor ma utworzyć — te dwie właściwości działają jako szablon dla nowej treści, a nie jako retrospektywna zmiana już wstawionych komórek. CellFormat udostępnia Borders, Shading, Width, WrapText, FitText, HorizontalMerge, VerticalMerge, VerticalAlignment, PreferredWidth oraz cztery właściwości wypełnienia (LeftPadding, RightPadding, TopPadding, BottomPadding), które wszystkie można ustawić jednocześnie przy użyciu SetPaddings(). RowFormat udostępnia Borders, Height, HeightRule, AllowBreakAcrossPages i HeadingFormat. Wywołaj CellFormat.ClearFormatting() lub RowFormat.ClearFormatting(), aby zresetować jedną z nich do wartości domyślnych przed ustawieniem nowych wartości dla kolejnego wiersza lub komórki.

Krok 5: Ustaw układ tabeli oraz AutoFit

Gdy tabela istnieje, ustaw właściwości układu bezpośrednio na obiekcie Table: Alignment (TableAlignment), Bidi, LeftIndent, PreferredWidth, Style, StyleIdentifier, StyleName, StyleOptions (TableStyleOptions) oraz TextWrapping. Wywołaj Table.SetBorders(), aby zastosować jeden styl obramowania, szerokość i kolor dla całej tabeli, lub Table.SetBorder(), aby ustawić pojedynczą krawędź; ClearBorders() i ClearShading() resetują je. Table.AutoFit(AutoFitBehavior) zmienia rozmiar tabeli i jej komórek zgodnie z wybranym zachowaniem — wywołaj go ponownie po każdej modyfikacji strukturalnej, ponieważ odzwierciedla on stan tabeli tylko w momencie uruchomienia, a nie ciągle.

Krok 6: Ustaw preferowane szerokości i szerokości komórek

Utwórz wartości szerokości za pomocą statycznych metod fabrycznych PreferredWidth.FromPercent() dla układu dostosowującego się do dostępnej szerokości strony lub PreferredWidth.FromPoints() dla stałej szerokości; PreferredWidthType informuje, jaki rodzaj wartości (Auto, Percent lub Points) posiada dany PreferredWidth. Przypisz wynik do Table.PreferredWidth dla całej tabeli lub CellFormat.PreferredWidth dla jednej komórki.

Krok 7: Scal komórki

Oznacz komórki jako scalone, ustawiając CellFormat.HorizontalMerge lub CellFormat.VerticalMerge (oba wpisane jako CellMerge) na komórkach, które mają uczestniczyć w scaleniu. Jeśli komórki wyglądały na scalone tylko dzięki dopasowaniu ich szerokości, a nie zostały wyraźnie oznaczone, wywołaj Table.ConvertToHorizontallyMergedCells(), aby przekształcić tę wizualną aranżację w komórki z rzeczywistym stanem CellMerge. CellVerticalAlignment kontroluje, jak zawartość jest wyrównana pionowo w komórce, niezależnie od jakiegokolwiek scalenia.

Krok 8: Odczyt tabel z istniejącego dokumentu

Aby pracować z tabelami już znajdującymi się w załadowanym dokumencie, odczytaj Body.Tables (lub właściwość Tables na dowolnym innym Story) — TableCollection — zamiast tworzyć nowe. Table.Rows zwraca RowCollection, a Row.Cells zwraca CellCollection; wszystkie trzy typy kolekcji obsługują Add(), Insert(), Remove(), RemoveAt(), Contains() i IndexOf() w celu programowych modyfikacji. Po usunięciu wierszy lub komórek wywołaj Table.EnsureMinimum(), Row.EnsureMinimum() lub Cell.EnsureMinimum(), aby węzeł zachował minimalną prawidłową strukturę wymaganą przez Word — pusty wiersz, pustą komórkę lub pusty akapit, odpowiednio.