C# Document Element Tutorial
IronWord jest potężną biblioteką dokumentów Word, zaprojektowaną aby wspierać programistów .NET C# w integracji możliwości tworzenia, odczytywania i edytowania dokumentów Word oraz DOCX w ich aplikacjach. W kontekście dokumentu Word, elementy dokumentu są blokami budującymi jego treść.
Szybki start: Tworzenie wystylizowanego TextRun i osadzanie obrazuOto, jak możesz użyć IronWord do dodania bogatej treści – łącząc wystylizowany tekst i osadzony obraz w dokumencie. Ten przyklad demonstruje wzorzec otulajacy Run dla tekstu z formatowaniem.
-
1Install IronWord with NuGet Package Manager
-
2Skopiuj i uruchom ten fragment kodu.
using IronWord; using IronWord.Models; // Create document WordDocument doc = new WordDocument(); // Create styled Run Run textRun = new Run(new TextContent("Hello IronWord!")); textRun.Style = new TextStyle() { IsBold = true, Color = Color.Blue }; // Create paragraph and add Run Paragraph paragraph = new Paragraph(); paragraph.AddChild(textRun); paragraph.AddImage(new ImageContent("pic.png")); // Add to document and save doc.AddParagraph(paragraph); doc.SaveAs("output.docx");C# -
3Wdrożenie do testowania w środowisku produkcyjnym
Rozpocznij używanie IronWord w swoim projekcie już dziś z darmową wersją próbną
Spis treści
- Dodaj tekst
- Treść tekstowa (Dodawanie, Dołączanie i Dzielnie)
- Ustalanie stylizacji (Rodzina czcionek i rozmiar, Kolor, Pogrubienie i Kursywa, Przekreślenie, Podkreślenie, Indeks górny i dolny)
- Osadzanie obrazów
- Dodawanie obrazów
- Ładowanie obrazu (Plik i FileStream)
- Ustawianie zawijania tekstu
- Ustawianie wymiarów (Szerokość i Wysokość)
- Ustawianie przesunięcia pozycji
- Ustawianie odległości od rogów
Kluczowe pojęcia
Hierarchia dokumentu
IronWord stosuje zorganizowana hierarchie dokumentow: Document → Paragraph → Run → TextContent. Zrozumienie tej hierarchii jest niezbędne do pracy z wystylizowanym tekstem:
WordDocument: Kontener nadrzedny reprezentujacy caly dokumentParagraph: Blok tresci w obrebie dokumentuRun: Obiekt otulajacy, zawierajacyTextContentz mozliwoscia zastosowania stylowTextContent: Faktyczny ciag tekstowy
Dodawanie treści do akapitów
IronWord dostarcza dwóch metod do dodawania treści do akapitów:
AddText(TextContent): Uzyc do niesformatowanego tekstu zwyklego. DodajeTextContentbezposrednio do akapitu.AddChild(Run): Uzyc do tekstu z formatowaniem. Dodaje obiektRun(ktory otaczaTextContenti przechowuje formatowanie) do akapitu.
Gdy potrzeba zastosowac formatowanie, takie jak rozmiar czcionki, kolor lub pogrubienie, nalezy utworzyc obiekt Run, przypisac TextStyle do Run i uzyc AddChild, aby dodac go do akapitu.
Dodawanie TextRun
Zawartość tekstu
Metoda Split jest wykorzystywana do podzialu ciagu tekstowego na liste mniejszych ciagow tekstowych, na podstawie okreslonego delimitera. Pozwala to na organizację i manipulację informacjami tekstowymi w dokumencie.
using IronWord;
using IronWord.Models;
WordDocument doc = new WordDocument();
// Add text
TextContent addText = new TextContent("Add text using IronWord");
doc.AddParagraph(new Paragraph(addText));
// Append text
TextContent appendText = new TextContent("The first text.");
appendText.Append(new TextContent("The second text."));
doc.AddParagraph(new Paragraph(appendText));
// Split text
TextContent splitText = new TextContent("Use split to split the sentence.");
splitText.Split(" ");
doc.AddParagraph(new Paragraph(splitText));
// Export docx
doc.SaveAs("textrun.docx");Imports IronWord
Imports IronWord.Models
Private doc As New WordDocument()
' Add text
Private addText As New TextContent("Add text using IronWord")
doc.AddParagraph(New Paragraph(addText))
' Append text
Dim appendText As New TextContent("The first text.")
appendText.Append(New TextContent("The second text."))
doc.AddParagraph(New Paragraph(appendText))
' Split text
Dim splitText As New TextContent("Use split to split the sentence.")
splitText.Split(" ")
doc.AddParagraph(New Paragraph(splitText))
' Export docx
doc.SaveAs("textrun.docx")Ustaw stylizację
Ustawianie formatu dla tekstu wymaga zastosowania wzorca otulajacego Run. Utworz obiekt Run zawierajacy TextContent, nastepnie przypisz TextStyle do Run (nie do TextContent). TextStyle pozwala zdefiniowac atrybuty wizualne, takie jak FontSize, kolor, pogrubienie, kursywa, przekreslenie, podkreslenie, indeks gorny i dolny.
Uwaga na to, ze FontSize jest konfigurowany na poziomie TextStyle, podczas gdy FontFamily ustawiony jest wewnatrz wlasciwosci TextFont. Po zastosowaniu formatowania, uzyj AddChild, aby dodac Run do akapitu. To nastepuje zgodnie z hierarchia dokumentu: Document → Paragraph → Run → TextContent.
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;
// Load docx
WordDocument doc = new WordDocument("document.docx");
// Configure text
Run textRun = new Run(new TextContent("Add text using IronWord"));
textRun.Style = new TextStyle()
{
FontSize = 72,
TextFont = new Font()
{
FontFamily = "Caveat"
},
Color = Color.Red,
IsBold = true,
IsItalic = true,
Underline = new Underline(),
Strike = StrikeValue.Strike,
};
Paragraph paragraph = new Paragraph();
// Add text
paragraph.AddChild(textRun);
// Add paragraph
doc.AddParagraph(paragraph);
// Export docx
doc.SaveAs("save_document.docx");Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums
' Load docx
Dim doc As New WordDocument("document.docx")
' Configure text
Dim textRun As New Run(New TextContent("Add text using IronWord"))
textRun.Style = New TextStyle() With {
.FontSize = 72,
.TextFont = New Font() With {
.FontFamily = "Caveat"
},
.Color = Color.Red,
.IsBold = True,
.IsItalic = True,
.Underline = New Underline(),
.Strike = StrikeValue.Strike
}
Dim paragraph As New Paragraph()
' Add text
paragraph.AddChild(textRun)
' Add paragraph
doc.AddParagraph(paragraph)
' Export docx
doc.SaveAs("save_document.docx")Uzyskiwanie koloru wypełnienia tekstu
Oprocz ustawiania formatu, IronWord zapewnia mozliwosc pobrania wartosci koloru RGBA z istniejacych dokumentow, aby zachowac spojnosc calego formatowania.
using IronWord;
using IronWord.Models;
using System;
// Open existing Word
WordDocument doc = new WordDocument("Accent1TextThemcolor.docx");
TextContent content = doc.Texts[0];
// This will show the R G B A of the themecolor
var filledColor = content.Color;
// Print the filled color variable to the console
Console.WriteLine(filledColor);Aby pobrac wartosci kolorow, nalezy wczytac dokument za pomoca WordDocument, nastepnie uzyskac dostep do kolekcji Paragraphs i tablicy Texts, aby otrzymac obiekt TextContent. Wlasciwosc Color obiektu TextContent zwraca wartosc RGBA istniejacego koloru tekstu, co pozwala na zachowanie spojnosc formatowania w calym dokumencie.
Osadzanie obrazów
Ta funkcja pozwala na bezproblemowe dołączanie obrazów do treści, zwiększając ogólną atrakcyjność wizualną i moc komunikacyjną dokumentu.
using IronWord;
using IronWord.Models;
// Load docx
WordDocument doc = new WordDocument();
// Configure image
ImageContent image = new ImageContent("image.jpg");
image.Width = 200; // In unit pixel
image.Height = 200; // In unit pixel
TextContent textRun = new TextContent();
// Add image
Paragraph para = new Paragraph(textRun);
para.AddImage(image);
// Add paragraph
doc.AddParagraph(para);
// Export docx
doc.SaveAs("save_document.docx");Dodaj obrazy
Ładowanie obrazu
Ładowanie obrazów jest kluczowym procesem. To obejmuje pobieranie zewnętrznych plików obrazu do dokumentu. Możliwość ładowania obrazów ułatwia dołączanie odpowiednich elementów wizualnych, przyczyniając się do bardziej wciągającego i pouczającego dokumentu.
using IronWord;
using IronWord.Models;
// Load docx
WordDocument doc = new WordDocument();
Paragraph paragraph = new Paragraph();
// Add image
paragraph.AddImage("image.jpg");
// Add paragraph
doc.AddParagraph(paragraph);
// Export docx
doc.SaveAs("document.docx");Imports IronWord
Imports IronWord.Models
' Load docx
Private doc As New WordDocument()
Private paragraph As New Paragraph()
' Add image
paragraph.AddImage("image.jpg")
' Add paragraph
doc.AddParagraph(paragraph)
' Export docx
doc.SaveAs("document.docx")Konfigurowanie obrazu
Optymalizuj obrazy za pomocą konfigurowalnych ustawień. Obejmuje to ustawianie właściwości, takich jak zawijanie tekstu, wymiary, pozycja i odległość od rogów. Odpowiednia konfiguracja zapewnia, że obrazy są wyświetlane w sposób atrakcyjny wizualnie i odpowiedni kontekstowo.
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;
// Load docx
WordDocument doc = new WordDocument();
// Configure image
ImageContent image = new ImageContent("image.jpg");
image.Width = 100;
image.Height = 100;
image.DistanceFromTop = 50;
var position = new ElementPosition();
position.X = 50;
position.Y = 50;
image.Position = position;
Paragraph paragraph = new Paragraph();
// Add image
paragraph.AddImage(image);
// Add paragraph
doc.AddParagraph(paragraph);
// Export docx
doc.SaveAs("document.docx");Często Zadawane Pytania
Jak mogę dodać tekst do dokumentu WORD za pomocą języka C#?
Możesz dodać tekst do dokumentu Word, używając IronWord do tworzenia instancji wpisu tekstowego, który można następnie dołączyć do akapitu w dokumencie.
Jaka jest metoda dzielenia tekstu w dokumencie Word?
IronWord udostępnia metodę Split, która pozwala podzielić wpis tekstowy na mniejsze segmenty na podstawie określonego separatora, ułatwiając manipulację tekstem.
Jak stylizować tekst w dokumencie Word za pomocą IronWord?
Możesz stylizować tekst w IronWord, ustawiając różne atrybuty, takie jak rozmiar czcionki, kolor i style jak pogrubienie, kursywa, przekreślenie, podkreślenie, indeks górny i dolny.
Jak mogę osadzić obrazy w dokumencie Word za pomocą C#?
Aby osadzić obrazy w dokumencie Word za pomocą IronWord, można załadować obraz z pliku i dodać go jako obraz inline do akapitu w dokumencie.
Jakie kroki są wymagane do załadowania obrazu do dokumentu Word?
Z IronWord, możesz załadować obraz z pliku lub strumienia plików, co umożliwia włączenie treści wizualnej do dokumentu Word.
Jak skonfigurować właściwości obrazu w dokumencie Word?
Korzystając z IronWord, możesz konfigurować właściwości obrazu takie jak owijanie tekstu, wymiary, przemieszczenie pozycji i odległość od narożników, aby zapewnić prawidłowe wyświetlanie obrazu w dokumencie.
Czy mogę pobrać wartość koloru RGBA tekstu w dokumencie Word?
Tak, IronWord pozwala uzyskać wartość koloru RGBA istniejącego tekstu w dokumencie, aby utrzymać spójność stylizacji.
Jak mogę rozpocząć używanie IronWord do manipulacji dokumentami Word?
Aby rozpocząć z IronWord, możesz zintegrować go ze swoją aplikacją .NET C#, aby tworzyć, czytać i edytować dokumenty Word, wykorzystując jego wszechstronne funkcje biblioteki.
How do you save a Word document created with IronWord?
A Word document created with IronWord can be saved using the 'SaveAs' method, specifying the filename and path for saving the document.
What is the function of the 'AddParagraph' method in IronWord?
The 'AddParagraph' method in IronWord is used to add fully configured paragraphs, with text and images, to a Word document.
Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.
