Click or drag to resize
DataTag Class
DataTag class represents a DataTag object.
Inheritance Hierarchy
SystemObject
  Aceoffix.WordWriterDataTag

Namespace: Aceoffix.WordWriter
Assembly: Aceoffix (in Aceoffix.dll) Version: 5.0.0.1
Syntax
public class DataTag

The DataTag type exposes the following members.

Properties
  NameDescription
Public propertyFont
Gets the font object.
Public propertyName
Gets the name of the DataTag.
Public propertyParagraphFormat
Gets the ParagraphFormat object.
Public propertyShading
Gets the Shading object.
Public propertyCode exampleValue
Sets the value of the DataTag.
Top
Remarks

DataTag object represents all text region matching with the pattern string in Word document. You can only call the OpenDataTag(String) method to get the DataTag object.

What is the DataTag? It's the pattern string defined by user in Word document. To put it simply, DataTag is a pattern string used to locate the content in Word document.

Here is an example to clarify what is DataTag. If the developer want the product name to display at the specified position in Word document that is to be opened, he can open this Word document, insert "(ProductName)" and save the document. Thus, the DataTage "(ProductName)" is defined.

The differences between DataTag and DataRegion: In Word document, it is a one-to-one relationship between the name of DataRegion and its location, while it's a one-to-many relationship between the name of DataTag and its locations. That is to say, the DataTag with the same characteristic string will show at many locations, and the DataRegion with the same name can only show at one location.

The disadvantage of DataTag is that it only can be used to fill a document. And DataRegion can fill and create a document as well as submit what user input into DataRegion. The advantage of DataTag is that it can fill the same content repeatedly in document. On the contrary, DataRegion cannot repeat. User must set different bookmarks. It will depend on your need to use DataRegion or DataTag.

See Also