Text property

The Text property sets or gets the primary character data that is associated with a field.

The characters of a field are stored as ASCII values in the page data XML file. In this sample XML node for the Vendor field, the fourth character contains a primary text value of 97. The first alternative text value is 52, and the second alternative text value is 97.

<F id="Vendor">
   <V n="TYPE">Vendor</V>
   <V n="Position">0,0,0,0</V>
   <V n="STATUS">1</V>
   <C cn="10,8,10" cr="0,0,0,0>68,49,68</C>
   <C cn="10,8,10" cr="0,0,0,0>97,50,97</C>
   <C cn="10,8,10" cr="0,0,0,0>116,51,116</C>
   <C cn="10,8,10" cr="0,0,0,0>97,52,97</C>
</F>        

Syntax

VBScript
Text as String
C#
string Text { set; get; }

Applies to

Field objects only.

Type

Read and write.

C# example

This example sets the primary character data in the Vendor field to IBM. The confidence values (cn attribute) are automatically set to high (9 in the code; 10 in the page XML file).

m_oDCOPage.FindChild("Vendor").Text = "IBM";
  • The text is the value that a task, such as Profiler, adds to a runtime field object.
  • If you use this property to replace existing data, all characters are assigned high confidence, unless you specify otherwise by using the ConfidenceString property.