Range

Range class

Représente une zone contiguë dans un document.

Pour en savoir plus, visitez leTravailler avec des plages article de documentation.

public class Range : IEnumerable<Node>

Propriétés

NomLa description
Bookmarks { get; }Renvoie unBookmarks collection qui représente tous les signets de la plage.
Fields { get; }Renvoie unFields collection qui représente tous les champs de la plage.
FormFields { get; }Renvoie unFormFields collection qui représente tous les champs de formulaire de la plage.
Revisions { get; }Obtient une collection de révisions (modifications suivies) qui existent dans cette plage.
StructuredDocumentTags { get; }Renvoie unStructuredDocumentTags collection qui représente toutes les balises de documents structurés dans la plage.
Text { get; }Obtient le texte de la plage.

Méthodes

NomLa description
Delete()Supprime tous les caractères de la plage.
GetEnumerator()
NormalizeFieldTypes()Modifie les valeurs du type de champFieldType deFieldStart ,FieldSeparator ,FieldEnd dans cette plage afin qu’ils correspondent aux types de champs contenus dans les codes de champ.
Replace(Regex, string)Remplace toutes les occurrences d’un modèle de caractère spécifié par une expression régulière par une autre chaîne.
Replace(string, string)Remplace toutes les occurrences d’un modèle de chaîne de caractères spécifié par une chaîne de remplacement.
Replace(Regex, string, FindReplaceOptions)Remplace toutes les occurrences d’un modèle de caractère spécifié par une expression régulière par une autre chaîne.
Replace(string, string, FindReplaceOptions)Remplace toutes les occurrences d’un modèle de chaîne de caractères spécifié par une chaîne de remplacement.
ToDocument()Construit un nouveau document entièrement formé qui contient la plage.
UnlinkFields()Dissocie les champs de cette plage.
UpdateFields()Met à jour les valeurs des champs de document dans cette plage.

Remarques

Le document est représenté par un arbre de nœuds et les nœuds fournissent des opérations pour travailler avec l’arbre, mais certaines opérations sont plus faciles à réaliser si le document est traité comme une séquence contiguë de texte.

Range est une interface « façade » qui fournit des méthodes qui traitent le document ou des parties du document comme du texte « plat », indépendamment du fait que les nœuds document sont stockés dans un modèle d’objet de type arborescence.

Range ne contient aucun texte ni nœud, c’est simplement une vue ou une « fenêtre » sur un fragment d’un document.

Exemples

Montre comment obtenir le contenu textuel de tous les nœuds couverts par une plage.

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

builder.Write("Hello world!");

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

Voir également