Interface ICharacterData

Inherited Members
Namespace: Telerik.Windows.Documents.FormatProviders.Html.Parsing.Dom
Assembly: Telerik.Windows.Controls.RichTextBox.dll

Syntax

public interface ICharacterData : INode

Properties

Data

The character data of the node that implements this interface. The DOM implementation may not put arbitrary limits on the amount of data that may be stored in a 

CharacterData
node. However, implementation limits may mean that the entirety of a node's data may not fit into a single 
DOMString
. In such cases, the user may call 
substringData
to retrieve the data in appropriately sized pieces.

Declaration
string Data { get; set; }
Property Value
System.String

Exceptions
DomException

NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.
DomException

DOMSTRING_SIZE_ERR: Raised when it would return more characters than fit in a 

DOMString
variable on the implementation platform.

Length

The number of 16-bit units that are available through 

data
and the 
substringData
method below. This may have the value zero, i.e., 
CharacterData
nodes may be empty.

Declaration
int Length { get; }
Property Value
System.Int32

Methods

AppendData(String)

Append the string to the end of the character data of the node. Upon success, 

data
provides access to the concatenation of 

data
and the 
DOMString
specified.
Declaration
void AppendData(string arg)
Parameters
System.String arg

Exceptions
DomException

NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

DeleteData(Int32, Int32)

Remove a range of 16-bit units from the node. Upon success, 

data
and 
length
reflect the change.
Declaration
void DeleteData(int offset, int count)
Parameters
System.Int32 offset

System.Int32 count

Exceptions
DomException

INDEX_SIZE_ERR: Raised if the specified 

offset
is negative or greater than the number of 16-bit units in 

data
, or if the specified 
count
is

negative.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

InsertData(Int32, String)

Declaration
void InsertData(int offset, string arg)
Parameters
System.Int32 offset

System.String arg

ReplaceData(Int32, Int32, String)

Replace the characters starting at the specified 16-bit unit offset with the specified string.

Declaration
void ReplaceData(int offset, int count, string arg)
Parameters
System.Int32 offset

System.Int32 count

System.String arg

Exceptions
DomException

INDEX_SIZE_ERR: Raised if the specified 

offset
is negative or greater than the number of 16-bit units in 

data
, or if the specified 
count
is

negative.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

SubstringData(Int32, Int32)

Extracts a range of data from the node.

Declaration
string SubstringData(int offset, int count)
Parameters
System.Int32 offset

System.Int32 count

Returns
System.String

The specified substring. If the sum of 

offset
and 

count
exceeds the 
length
, then all 16-bit

units to the end of the data are returned.
Exceptions
DomException

INDEX_SIZE_ERR: Raised if the specified 

offset
is negative or greater than the number of 16-bit units in 

data
, or if the specified 
count
is

negative.
DOMSTRING_SIZE_ERR: Raised if the specified range of text does not fit into a 

DOMString
.

Extension Methods