Range

Range class

Stellt einen zusammenhängenden Bereich in einem Dokument dar.

Um mehr zu erfahren, besuchen Sie dieArbeiten mit Bereichen Dokumentationsartikel.

public class Range : IEnumerable<Node>

Eigenschaften

NameBeschreibung
Bookmarks { get; }Gibt einenBookmarks Sammlung, die alle Lesezeichen im Bereich darstellt.
Fields { get; }Gibt einenFields Sammlung, die alle Felder im Bereich darstellt.
FormFields { get; }Gibt einenFormFields Sammlung, die alle Formularfelder im Bereich darstellt.
Revisions { get; }Ruft eine Sammlung von Revisionen (nachverfolgten Änderungen) ab, die in diesem Bereich vorhanden sind.
StructuredDocumentTags { get; }Gibt einenStructuredDocumentTags Sammlung, die alle strukturierten Dokument-Tags im Bereich darstellt.
Text { get; }Ruft den Text des Bereichs ab.

Methoden

NameBeschreibung
Delete()Löscht alle Zeichen des Bereichs.
GetEnumerator()
NormalizeFieldTypes()Ändert FeldtypwerteFieldType vonFieldStart ,FieldSeparator ,FieldEnd in diesem Bereich, sodass sie den in den Feldcodes enthaltenen Feldtypen entsprechen.
Replace(Regex, string)Ersetzt alle Vorkommen eines durch einen regulären Ausdruck angegebenen Zeichenmusters durch eine andere Zeichenfolge.
Replace(string, string)Ersetzt alle Vorkommen eines angegebenen Zeichenfolgenmusters durch eine Ersatzzeichenfolge.
Replace(Regex, string, FindReplaceOptions)Ersetzt alle Vorkommen eines durch einen regulären Ausdruck angegebenen Zeichenmusters durch eine andere Zeichenfolge.
Replace(string, string, FindReplaceOptions)Ersetzt alle Vorkommen eines angegebenen Zeichenfolgenmusters durch eine Ersatzzeichenfolge.
ToDocument()Erstellt ein neues, vollständig formatiertes Dokument, das den Bereich enthält.
UnlinkFields()Hebt die Verknüpfung der Felder in diesem Bereich auf.
UpdateFields()Aktualisiert die Werte der Dokumentfelder in diesem Bereich.

Bemerkungen

Das Dokument wird durch einen Knotenbaum dargestellt und die Knoten stellen Operationen bereit, um mit dem Baum zu arbeiten. Einige Operationen lassen sich jedoch leichter ausführen, wenn das Dokument als zusammenhängende Textsequenz behandelt wird.

Range ist eine „Fassaden“-Schnittstelle, die Methoden bereitstellt, die document oder Teile des Dokuments als „flachen“ Text behandeln, unabhängig von der Tatsache, dass die document -Knoten in einem baumartigen Objektmodell gespeichert sind.

Range enthält keinen Text oder Knoten, es ist lediglich eine Ansicht oder ein „Fenster“ über einem Dokumentfragment.

Beispiele

Zeigt, wie der Textinhalt aller Knoten abgerufen wird, die ein Bereich abdeckt.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Write("Hello world!");

Assert.AreEqual("Hello world!", doc.Range.Text.Trim());

Siehe auch