Wie man mit Text in .NET arbeitet

Schritt 1: Bibliothek holen

Klonen Sie das Repository und bauen Sie es Aspose.Words.sln in der Release-Konfiguration, dann fügen Sie einen Projektverweis zu Aspose.Words.csproj aus Ihrem eigenen .NET-Projekt, wie im Installationshandbuch. Hinzufügen using Aspose.Words; am Anfang jeder Datei, die mit Text arbeitet.

Schritt 2: Schriftart eines Runs formatieren

Ein Run ist ein Textabschnitt, der ein Satz von Formatierungen gemeinsam nutzt; seine Text-Eigenschaft enthält den Klartextinhalt und ihre Font-Eigenschaft (ein Font-Objekt) enthält die Zeichenformatierung — Name, Size, Bold, Italic, Underline, Color, HighlightColor, Subscript/Superscript und StrikeThrough unter anderem. Font.ClearFormatting() setzt einen Run auf die Standardwerte zurück. Die Runs eines Absatzes sind über seine Runs-Eigenschaft verfügbar, ein RunCollection. Das Festlegen von Schriftarteigenschaften auf DocumentBuilder.Font, bevor neuer Text geschrieben wird, ist in der Regel einfacher, als einzelne Run-Objekte nachträglich zu formatieren.

Schritt 3: Absatz formatieren

Paragraph.ParagraphFormat (ein ParagraphFormat-Objekt) steuert das Layout auf Absatzebene: Alignment, Einzüge (LeftIndent, RightIndent, FirstLineIndent), Abstände (SpaceBefore, SpaceAfter, LineSpacing, LineSpacingRule) und das Seitenumbruchverhalten (KeepTogether, KeepWithNext, PageBreakBefore, WidowControl). ParagraphFormat.ClearFormatting() setzt diese auf die Standardwerte zurück, und Paragraph.JoinRunsWithSameFormatting() fügt benachbarte Runs zusammen, die identische Formatierung besitzen — nützlich, nachdem eine Reihe programmatischer Änderungen einen Absatz mit mehr Runs als nötig hinterlassen hat.

Schritt 4: Text im Bereich suchen und ersetzen

Jeder inhaltstragende Knoten — ein Document, Section, Paragraph oder Run — stellt ein Range zur Verfügung. Range.Text gibt den Klartext von allem innerhalb dieses Bereichs zurück, und Range.Replace(pattern, replacement) führt ein Suchen-und-Ersetzen ausschließlich für diesen Bereich aus: Rufen Sie es auf dem Range eines Paragraph auf, um den Text nur in einem Absatz zu ändern, oder auf Document.Range, um das gesamte Dokument zu durchsuchen. Range.Delete() entfernt den Inhalt des Bereichs vollständig.

Schritt 5: Kommentar hinzufügen

Erzeugen Sie ein Comment mit new Comment(doc, author, initial, dateTime), setzen Sie dessen Text mit SetText(text) und fügen Sie es dann wie jeden anderen Knoten in den Baum ein. Comment.AddReply(author, initial, dateTime, text) fügt eine Thread-Antwort hinzu — selbst ein Comment — und RemoveReply(reply) / RemoveAllReplies() entfernen Antworten wieder. Die Kommentare eines Dokuments werden in einem CommentCollection gesammelt.

Schritt 6: Einen Absatz in ein Listenelement umwandeln

Paragraph.ListFormat (ein ListFormat-Objekt) meldet und steuert, ob ein Absatz an einer Liste teilnimmt: IsListItem und ListLevelNumber geben den aktuellen Zustand wieder. ApplyBulletDefault() verwandelt den Absatz in ein standardmäßiges Aufzählungszeichen, und ApplyNumberDefault() in ein standardmäßiges nummeriertes Element; ListIndent() / ListOutdent() ändern dessen Verschachtelungsebene, und RemoveNumbers() wandelt ihn zurück in einen einfachen Absatz.