Wstaw spis treści do dokumentu programu Word

W tym obszernym samouczku dowiesz się, jak wstawić spis treści do dokumentu programu Word przy użyciu Aspose.Words dla .NET. Przeprowadzimy Cię przez proces i udostępnimy niezbędne fragmenty kodu C#. Pod koniec tego przewodnika będziesz w stanie wygenerować spis treści z odpowiednimi nagłówkami i numerami stron.

Warunki wstępne

Zanim zaczniemy, upewnij się, że masz następujące wymagania wstępne:

  • Biblioteka Aspose.Words dla .NET zainstalowana w Twoim systemie.

Krok 1: Utwórz nowy dokument i narzędzie DocumentBuider

Aby rozpocząć, utwórz nowy dokument za pomocą klasy Document i zainicjuj obiekt DocumentBuilder:

string dataDir = "YOUR DOCUMENT DIRECTORY";
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Krok 2: Wstaw spis treści

Następnie użyj metody InsertTableOfContents klasy DocumentBuilder, aby wstawić spis treści. Określ wymagane opcje formatowania w ramach metody:

builder.InsertTableOfContents("\\o \"1-3\" \\h \\z \\u");

Krok 3: Dodaj treść dokumentu

Po wstawieniu spisu treści należy dodać rzeczywistą treść dokumentu. Ustaw odpowiednie style nagłówków za pomocą StyleIdentifier:

builder.InsertBreak(BreakType.PageBreak);

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading1;
builder.Writeln("Heading 1");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading2;
builder.Writeln("Heading 1.1");
builder.Writeln("Heading 1.2");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading1;
builder.Writeln("Heading 2");
builder.Writeln("Heading 3");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading2;
builder.Writeln("Heading 3.1");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading3;
builder.Writeln("Heading 3.1.1");
builder.Writeln("Heading 3.1.2");
builder.Writeln("Heading 3.1.3");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading2;
builder.Writeln("Heading 3.2");
builder.Writeln("Heading 3.3");

Krok 4: Zaktualizuj spis treści

Nowo wstawiony spis treści będzie początkowo pusty. Aby go wypełnić, zaktualizuj pola w dokumencie:

doc.UpdateFields();

Krok 5: Zapisz dokument

Po wstawieniu spisu treści i aktualizacji pól należy zapisać dokument do pliku korzystając z metody Save klasy Document:

doc.Save(dataDir + "AddContentUsingDocumentBuilder.InsertTableOfContents.docx");

Przykładowy kod źródłowy do wstawiania spisu treści przy użyciu Aspose.Words dla .NET

Oto kompletny kod źródłowy do wstawiania spisu treści przy użyciu Aspose.Words dla .NET:

string dataDir = "YOUR DOCUMENT DIRECTORY";

// Zainicjuj DocumentBuilder za pomocą obiektu Document
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Wstaw spis treścia
builder.InsertTableOfContents("\\o \"1-3\" \\h \\z \\u");

// Rozpocznij właściwą treść dokumentu na drugiej stronie.
builder.InsertBreak(BreakType.PageBreak);

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading1;

builder.Writeln("Heading 1");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading2;

builder.Writeln("Heading 1.1");
builder.Writeln("Heading 1.2");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading1;

builder.Writeln("Heading 2");
builder.Writeln("Heading 3");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading2;

builder.Writeln("Heading 3.1");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading3;

builder.Writeln("Heading 3.1.1");
builder.Writeln("Heading 3.1.2");
builder.Writeln("Heading 3.1.3");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading2;

builder.Writeln("Heading 3.2");
builder.Writeln("Heading 3.3");


// Nowo wstawiony spis treści będzie początkowo pusty.
// Należy go wypełnić poprzez aktualizację pól w dokumencie.
doc.UpdateFields();


doc.Save(dataDir + "AddContentUsingDocumentBuilder.InsertTableOfContents.docx");

Wniosek

Gratulacje! Pomyślnie nauczyłeś się, jak wstawić spis treści do dokumentu programu Word przy użyciu Aspose.Words dla .NET. Postępując zgodnie z tym przewodnikiem krok po kroku i wykorzystując dostarczony kod źródłowy, możesz teraz wygenerować spis treści z odpowiednimi nagłówkami i numerami stron dla swoich dokumentów.

Często zadawane pytania dotyczące wstawiania spisu treści w dokumencie programu Word

P: Czy mogę dostosować wygląd spisu treści?

O: Tak, możesz dostosować wygląd spisu treści, modyfikując opcje formatowania określone w plikuInsertTableOfContents metoda. Parametry umożliwiają kontrolowanie numerów stron, wcięć i innych stylów.

P: Co się stanie, jeśli chcę uwzględnić w spisie treści określone poziomy nagłówków?

O: Możesz określić żądane poziomy nagłówków, które mają być uwzględnione w spisie treści, dostosowując wartość w obrębieInsertTableOfContents metoda. Na przykład za pomocą"\\o \"1-3\"" będzie obejmować poziomy nagłówków od 1 do 3.

P: Czy mogę automatycznie zaktualizować spis treści, jeśli dokonam zmian w treści dokumentu?

O: Tak, możesz automatycznie zaktualizować spis treści, wywołując metodęUpdateFields metoda na dokumencie. Dzięki temu wszelkie zmiany dokonane w treści dokumentu, takie jak dodanie lub usunięcie nagłówków, zostaną odzwierciedlone w spisie treści.

P: Jak mogę zmienić styl poziomów nagłówków w spisie treści?

O: Możesz stylizować poziomy nagłówków w różny sposób, używając różnych stylów akapitów dla każdego poziomu nagłówków. Przypisując różneStyleIdentifier wartości doParagraphFormat zDocumentBuilder, możesz utworzyć odrębne style dla każdego poziomu nagłówka.

P: Czy można dodać dodatkowe formatowanie nagłówków w spisie treści?

O: Tak, możesz dodać dodatkowe formatowanie do nagłówków spisu treści, takie jak style czcionek, kolory i inne właściwości. DostosowującFont właściwościDocumentBuilder, możesz zastosować niestandardowe formatowanie nagłówków.