New to Telerik UI for WPF? Start a free 30-day trial

ICharacterData

Interface

Definition

Namespace:Telerik.Windows.Documents.FormatProviders.Html.Parsing.Dom

Assembly:Telerik.Windows.Controls.RichTextBox.dll

Syntax:

public interface ICharacterData : INode

Inherited Members INode.InsertBefore(INode, INode)INode.ReplaceChild(INode, INode)INode.RemoveChild(INode)INode.AppendChild(INode)INode.HasChildNodes()INode.CloneNode(bool)INode.Normalize()INode.IsSupported(string, string)INode.HasAttributes()INode.NodeNameINode.NodeValueINode.NodeTypeINode.ParentNodeINode.ChildNodesINode.FirstChildINode.LastChildINode.PreviousSiblingINode.NextSiblingINode.AttributesINode.OwnerDocumentINode.NamespaceURIINode.PrefixINode.LocalName...

Properties

Data

string

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

       <pre><code class="lang-csharp">CharacterData</code></pre>

node. However, implementation limits may mean that the entirety of a node's data may not fit into a single

       <pre><code class="lang-csharp">DOMString</code></pre>

       . In such cases, the user 
       may call 

       <pre><code class="lang-csharp">substringData</code></pre>

to retrieve the data in appropriately sized pieces.

string Data { get; set; }

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 

       <pre><code class="lang-csharp">DOMString</code></pre>

variable on the implementation platform.

Length

int

The number of 16-bit units that are available through

       <pre><code class="lang-csharp">data</code></pre> 

       and the 

       <pre><code class="lang-csharp">substringData</code></pre>

method below. This may have the value zero, i.e.,

       <pre><code class="lang-csharp">CharacterData</code></pre>

nodes may be empty.

int Length { get; }

Methods

AppendData(string)

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

       <pre><code class="lang-csharp">data</code></pre>

provides access to the concatenation of

       <pre><code class="lang-csharp">data</code></pre>

and the

csharp

DOMString

specified.

void AppendData(string arg)

Parameters:argstringExceptions: DomException

NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

DeleteData(int, int)

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

       <pre><code class="lang-csharp">data</code></pre>

and

csharp

length

reflect the change.

void DeleteData(int offset, int count)

Parameters:offsetintcountint

DomException

       INDEX_SIZE_ERR: Raised if the specified 

       <pre><code class="lang-csharp">offset</code></pre>

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

       <pre><code class="lang-csharp">data</code></pre>

       , or if the specified 

       <pre><code class="lang-csharp">count</code></pre>

is negative.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

InsertData(int, string)

void InsertData(int offset, string arg)

Parameters:offsetintargstring

ReplaceData(int, int, string)

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

void ReplaceData(int offset, int count, string arg)

Parameters:offsetintcountintargstring

DomException

       INDEX_SIZE_ERR: Raised if the specified 

       <pre><code class="lang-csharp">offset</code></pre>

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

       <pre><code class="lang-csharp">data</code></pre>

       , or if the specified 

       <pre><code class="lang-csharp">count</code></pre>

is negative.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

SubstringData(int, int)

Extracts a range of data from the node.

string SubstringData(int offset, int count)

Parameters:offsetintcountint

string

The specified substring. If the sum of

       <pre><code class="lang-csharp">offset</code></pre>

and

       <pre><code class="lang-csharp">count</code></pre>

exceeds the

csharp

length

, then all 16-bit units to the end of the data are returned.

DomException

       INDEX_SIZE_ERR: Raised if the specified 

       <pre><code class="lang-csharp">offset</code></pre>

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

       <pre><code class="lang-csharp">data</code></pre>

       , or if the specified 

       <pre><code class="lang-csharp">count</code></pre>

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

       <pre><code class="lang-csharp">DOMString</code></pre>

       .