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

Eigenschaften

NameBeschreibung
Bookmarks { get; }Gibt a zurückBookmarks Sammlung, die alle Lesezeichen im Bereich darstellt.
Fields { get; }Gibt a zurückFields Sammlung, die alle Felder im Bereich darstellt.
FormFields { get; }Gibt a zurückFormFields 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 a zurückStructuredDocumentTags 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.
NormalizeFieldTypes()Ändert FeldtypwerteFieldType vonFieldStart ,FieldSeparator ,FieldEnd in diesem Bereich, damit 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 geformtes Dokument, das den Bereich enthält.
UnlinkFields()Hebt die Verknüpfung von Feldern in diesem Bereich auf.
UpdateFields()Aktualisiert die Werte von Dokumentfeldern in diesem Bereich.

Bemerkungen

Das Dokument wird durch einen Knotenbaum dargestellt und die Knoten stellen Operationen für die Arbeit mit dem Baum bereit. Einige Operationen sind jedoch einfacher auszuführen, wenn das Dokument als zusammenhängende Textsequenz behandelt wird.

Rangeist 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 ein Fragment eines Dokuments.

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