Tworzenie sekcji powtarzanej tabeli odwzorowanej na niestandardową część Xml
Wstęp
W tym samouczku omówimy proces tworzenia tabeli z powtarzającą się sekcją, która jest mapowana na niestandardową część XML za pomocą Aspose.Words dla .NET. Jest to szczególnie przydatne przy dynamicznym generowaniu dokumentów w oparciu o ustrukturyzowane dane.
Warunki wstępne
Zanim zaczniemy, upewnij się, że masz następujące elementy:
- Zainstalowana biblioteka Aspose.Words dla .NET. Można go pobrać zStrona Aspose.
- Podstawowa znajomość C# i XML.
Importuj przestrzenie nazw
Pamiętaj o uwzględnieniu w projekcie niezbędnych przestrzeni nazw:
using Aspose.Words;
using Aspose.Words.Markup;
using Aspose.Words.Tables;
Krok 1: Zainicjuj dokument i narzędzie DocumentBuider
Najpierw utwórz nowy dokument i zainicjuj plikDocumentBuilder
:
string dataDir = "YOUR DOCUMENT DIRECTORY";
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Krok 2: Dodaj niestandardową część XML
Dodaj niestandardową część XML do dokumentu. Ten plik XML zawiera dane, które chcemy zmapować do naszej tabeli:
CustomXmlPart xmlPart = doc.CustomXmlParts.Add("Books",
"<books><book><title>Everyday Italian</title><author>Giada De Laurentiis</author></book>" +
"<book><title>Harry Potter</title><author>J K. Rowling</author></book>" +
"<book><title>Learning XML</title><author>Erik T. Ray</author></book></books>");
Krok 3: Utwórz strukturę tabeli
Następnie użyjDocumentBuilder
aby utworzyć nagłówek tabeli:
Table table = builder.StartTable();
builder.InsertCell();
builder.Write("Title");
builder.InsertCell();
builder.Write("Author");
builder.EndRow();
builder.EndTable();
Krok 4: Utwórz sekcję powtarzalną
UtwórzStructuredDocumentTag
(SDT) dla sekcji powtarzalnej i zmapuj ją na dane XML:
StructuredDocumentTag repeatingSectionSdt = new StructuredDocumentTag(doc, SdtType.RepeatingSection, MarkupLevel.Row);
repeatingSectionSdt.XmlMapping.SetMapping(xmlPart, "/books[1]/book", "");
table.AppendChild(repeatingSectionSdt);
Krok 5: Utwórz element sekcji powtarzalnej
Utwórz SDT dla elementu sekcji powtarzanej i dodaj go do sekcji powtarzanej:
StructuredDocumentTag repeatingSectionItemSdt = new StructuredDocumentTag(doc, SdtType.RepeatingSectionItem, MarkupLevel.Row);
repeatingSectionSdt.AppendChild(repeatingSectionItemSdt);
Row row = new Row(doc);
repeatingSectionItemSdt.AppendChild(row);
Krok 6: Mapuj dane XML na komórki tabeli
Utwórz SDT dla tytułu i autora, zmapuj je do danych XML i dołącz je do wiersza:
StructuredDocumentTag titleSdt = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Cell);
titleSdt.XmlMapping.SetMapping(xmlPart, "/books[1]/book[1]/title[1]", "");
row.AppendChild(titleSdt);
StructuredDocumentTag authorSdt = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Cell);
authorSdt.XmlMapping.SetMapping(xmlPart, "/books[1]/book[1]/author[1]", "");
row.AppendChild(authorSdt);
Krok 7: Zapisz dokument
Na koniec zapisz dokument we wskazanym katalogu:
doc.Save(dataDir + "WorkingWithSdt.CreatingTableRepeatingSectionMappedToCustomXmlPart.docx");
Wniosek
Wykonując te kroki, pomyślnie utworzyłeś tabelę z powtarzającą się sekcją odwzorowaną na niestandardową część XML przy użyciu Aspose.Words dla .NET. Pozwala to na dynamiczne generowanie treści w oparciu o dane strukturalne, dzięki czemu tworzenie dokumentów jest bardziej elastyczne i wydajne.
Często zadawane pytania
Co to jest tag dokumentu strukturalnego (SDT)?
SDT, znany również jako kontrola treści, to ograniczony region w dokumencie używany do przechowywania danych strukturalnych.
Czy mogę używać innych typów danych w niestandardowej części XML?
Tak, możesz ustrukturyzować swoją niestandardową część XML za pomocą dowolnych typów danych i odpowiednio je zmapować.
Jak dodać więcej wierszy do sekcji powtarzanej?
Sekcja powtarzana automatycznie replikuje strukturę wierszy dla każdego elementu w mapowanej ścieżce XML.