Range Class

Represents a contiguous area in a document.

Inheritance Hierarchy

SystemObject
Aspose.WordsRange

Namespace: Aspose.Words
Assembly: Aspose.Words (in Aspose.Words.dll) Version: 20.3

Syntax

C++

public class Range

Public Class Range

public ref class Range

type Range =  class end

The Range type exposes the following members.

Properties

	Name	Description
	Bookmarks	Returns a Bookmarks collection that represents all bookmarks in the range.
	Fields	Returns a Fields collection that represents all fields in the range.
	FormFields	Returns a FormFields collection that represents all form fields in the range.
	Text	Gets the text of the range.

Methods

	Name	Description
	Delete	Deletes all characters of the range.
	Equals	(Inherited from Object.)
	GetHashCode	(Inherited from Object.)
	GetType	(Inherited from Object.)
	NormalizeFieldTypes	Changes field type values FieldType of FieldStart, FieldSeparator, FieldEnd in this range so that they correspond to the field types contained in the field codes.
	Replace(String, String)	Replaces all occurrences of a character pattern specified by a regular expression with another string.
	Replace(Regex, String)	Replaces all occurrences of a character pattern specified by a regular expression with another string.
	Replace(String, String, FindReplaceOptions)	Replaces all occurrences of a character pattern specified by a regular expression with another string.
	Replace(Regex, String, FindReplaceOptions)	Replaces all occurrences of a character pattern specified by a regular expression with another string.
	ToDocument	Constructs a new fully formed document that contains the range.
	ToString	(Inherited from Object.)
	UnlinkFields	Unlinks fields in this range.
	UpdateFields	Updates the values of document fields in this range.

Remarks

The document is represented by a tree of nodes and the nodes provide operations to work with the tree, but some operations are easier to perform if the document is treated as a contiguous sequence of text.

Range is a "facade" interface that provide methods that treat the document or portions of the document as "flat" text regardless of the fact that the document nodes are stored in a tree-like object model.

Range does not contain any text or nodes, it is merely a view or "window" over a fragment of a document.

Examples

Shows how to get plain, unformatted text of a range.

Document doc = new Document(MyDir + "Document.docx");
string text = doc.Range.Text;

Reference

Aspose.Words Namespace