AttributeTag Class

An AttributeTag represents a Tagged Value associated with an attribute.

Associated table in .EAP file:     t_attributetag

AttributeTag Attributes:

Attribute

Type

Notes

AttributeID

Long

Read/Write

The local ID of the attribute associated with this Tagged Value.

 

FQName

String

Read only

The fully-qualified name of the tag.

 

Name

String

Read/Write

The name of the tag.

 

Notes

String

Read/Write

Further descriptive notes about this tag.

If Value (below) is set to "<memo>", then Notes should contain the actual Tagged Value content.

 

ObjectType

ObjectType

Read only

Distinguishes objects referenced through a Dispatch interface.

 

TagGUID

String

Read/Write

A globally unique ID for this Tagged Value.

 

TagID

Long

Read only

The local ID to identify the Tagged Value.

 

Value

String

Read/Write

The value assigned to this tag.

This field has a 255 character limit. If the value is greater than 255 characters long, set the value to "<memo>" and insert the body of text in the Notes attribute (above).

When reading existing Tagged Values, if Value = "<memo>" then the developer should read the actual body of text from the Notes attribute.

 

AttributeTag Methods:

Method

Type

Notes

GetAttribute(string propName)

String

Returns the text of a single named property within a structured tagged value.

 

GetLastError()

String

Returns a string value describing the most recent error that occurred in relation to this object.

This function is rarely used as an exception is thrown when an error occurs.

 

HasAttributes()

Boolean

Returns true if the tagged values is a structured tagged value with one or more properties.

 

SetAttribute(string propName, string propValue)

Boolean

Sets the text of a single named property within a structured tagged value.

Update ()

Boolean

Updates the current AttributeTag object after modification or appending a new item.

If false is returned, check the GetLastError function for more information.