Range

Range class

Stellt einen zusammenhängenden Bereich in einem Dokument dar.

public class Range

Eigenschaften

Name Beschreibung
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.
StructuredDocumentTags { get; } Gibt a zurückStructuredDocumentTags Sammlung, die alle strukturierten Dokument-Tags im Bereich darstellt.
Text { get; } Ruft den Text des Bereichs ab.

Methoden

Name Beschreibung
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 formatiertes Dokument, das den Bereich enthält.
UnlinkFields() Hebt die Verknüpfung von Feldern 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, aber einige Operationen sind einfacher durchzuführen, wenn das Dokument als zusammenhängende Textfolge behandelt wird.

Bereich ist eine “Fassaden”-Schnittstelle, die Methoden bereitstellt, die document oder Teile des Dokuments als “flachen” Text behandeln, ungeachtet der Tatsache, dass die document -Knoten in einem baumähnlichen Objektmodell gespeichert sind.

Bereich enthält keinen Text oder Knoten, es ist lediglich eine Ansicht oder ein “Fenster” über einem 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