Range

Range class

Représente une zone contiguë dans un document.

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

public class Range

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 document structuré de la plage.
Text { get; }Récupère le texte de la plage.

Méthodes

NomLa description
Delete()Supprime tous les caractères de la plage.
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 champs.
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 du document dans cette plage.

Remarques

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

Rangeest 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 objet arborescent.

Range ne contient aucun texte ni nœud, il s’agit simplement d’une vue ou d’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