AddToRecordError class: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 1: Line 1:
<!-- AddToRecordError class -->
<!-- AddToRecordError class -->
__NOTOC__


An <var>AddToRecordError</var> exception can be thrown by the <var>[[AddToRecord (XmlDoc subroutine)|AddToRecord]]</var> subroutine in the <var>[[XmlDoc_API#The_XmlDoc_class|XmlDoc]]</var> class.  It indicates that not all of the fields and/or fieldgroups from the object <var>XmlDoc</var> were successfully added to the current record.  The various read-only properties of an <var>AddToRecordError</var> object (which can be set by the <var>[[Catch]]</var> statement) provide information about the failed operation.
An <var>AddToRecordError</var> exception can be thrown by the <var>[[AddToRecord (XmlDoc subroutine)|AddToRecord]]</var> subroutine in the <var>[[XmlDoc_API#The_XmlDoc_class|XmlDoc]]</var> class.  It indicates that not all of the fields and/or fieldgroups from the object <var>XmlDoc</var> were successfully added to the current record.  The various read-only properties of an <var>AddToRecordError</var> object (which can be set by the <var>[[Catch]]</var> statement) provide information about the failed operation.


The methods in this class are summarized in "[[List of AddToRecordError methods]]".
This class is new in version 7.8 of the <var class="product">Sirius Mods</var>.
 
==The AddToRecordError methods==
 
{{Template:List of AddToRecordError methods}}
 
The methods in the class are described in the subsections that follow. In addition:
<ul>
<li>[[Notation conventions for methods|"Notation conventions for methods"]] has information
about the conventions followed.
<li>[[AddToRecordError methods syntax|"AddToRecordError methods syntax"]] is a single page that contains the syntax diagrams of all the methods in the class.
</ul>
 
 
<h2>Description property</h2>
{{Template:AddToRecordError:Description subtitle}}
<h4>Syntax</h4>
{{Template:AddToRecordError:Description syntax}}
<h4>Syntax terms</h4>
<table class="syntaxTable">
<tr><th>%string</th>
<td>A string to receive the description of the exception.
</td></tr>
<tr><th>addToRecordError</th>
<td>An <var>[[AddToRecordError_class|AddToRecordError]]</var> object.
</td></tr></table>
 
<h4>Usage Notes</h4>
<ul>
<li><var>Description</var> is available in <var class="product">[[Sirius Mods|Sirius Mods]]</var> Version 7.8 and later.
</ul>
 
 
<h2>FieldOrFieldgroupName property</h2>
{{Template:AddToRecordError:FieldOrFieldgroupName subtitle}}
<h4>Syntax</h4>
{{Template:AddToRecordError:FieldOrFieldgroupName syntax}}
<h4>Syntax terms</h4>
<table class="syntaxTable">
<tr><th>%string</th>
<td>A string to receive the field or fieldgroup name. If the error involves a field or fieldgroup (for example, if <code>[[Reason (AddToRecordError property)|Reason]] = ErrorAddingField</code>), this is the field or fieldgroup name.
</td></tr>
<tr><th>addToRecordError</th>
<td>An <var>[[AddToRecordError_class|AddToRecordError]]</var> object.
</td></tr></table>
 
<h4>Usage Notes</h4>
<ul>
<li><var>FieldOrFieldgroupName</var> is available in <var class="product">[[Sirius Mods|Sirius Mods]]</var> Version 7.8 and later.
</ul>
 
 
<h2>InputRecordNumber property</h2>
{{Template:AddToRecordError:InputRecordNumber subtitle}}
<h4>Syntax</h4>
{{Template:AddToRecordError:InputRecordNumber syntax}}
<h4>Syntax terms</h4>
<table class="syntaxTable">
<tr><th>%number</th>
<td>A string to receive the value of the <code>number</code> attribute of the <code>Record</code> element of <var>[[AddToRecord (XmlDoc subroutine)|AddToRecord]]</var>'s method object <var>[[XmlDoc class|XmlDoc]]</var>. Assuming that the <var>XmlDoc</var> was created by the <var>[[LoadFromRecord (XmlDoc/XmlNode subroutine)|LoadFromRecord]]</var> subroutine (or one of the methods analagous to it), this will be the number of the record from which the <var>XmlDoc</var> was created.
</td></tr>
<tr><th>%addtoRecordError</th>
<td>An <var>[[AddToRecordError_class|AddToRecordError]]</var> object.
</td></tr></table>
 
<h4>Usage Notes</h4>
<ul>
<li><var>InputRecordNumber</var> is available in <var class="product">[[Sirius Mods|Sirius Mods]]</var> Version 7.8 and later.
</ul>
 
 
<h2>New constructor</h2>
{{Template:AddToRecordError:New subtitle}}
Each argument to <var>New</var> sets the value of the corresponding property of the newly constructed <var>[[AddToRecordError_class|AddToRecordError]]</var> object.                             
<h4>Syntax</h4>
{{Template:AddToRecordError:New syntax}}
<h4>Syntax terms</h4>
<table class="syntaxTable">
<tr><th>%addToRecordError</th>
<td>An <var>AddToRecordError</var> object.
</td></tr>
<tr><th><var>Reason</var></th>
<td>This [[Methods#Named parameters|name required]] parameter specifies the <var>AddToRecordErrorReason</var> enumeration value to be assigned to the exception object's <var class="term>[[Reason (AddToRecordError property)|Reason]]</var> property.  <var class="term">Reason</var> is a required parameter.
</td></tr>
<tr><th><var>Description</var></th>
<td>This name required parameter specifies the string value to be assigned to the object's <var>[[Description (AddToRecordError property)|Description]]</var> property. <var class="term">Description</var> is an optional parameter; the default value is the null string.
</td></tr>
<tr><th><var>UntranslatableHexValue</var></th>
<td>This name required parameter specifies the string value to be assigned to the object's <var>[[UntranslatableHexValue (AddToRecordError property)|UntranslatableHexValue]]</var> property. <var class="term">UntranslatableHexValue</var> is an optional parameter; the default value is the null string and, if supplied, it must be a valid hexadecimal string.
</td></tr>
<tr><th><var>FieldOrFieldgroupName</var></th>
<td>This name required parameter specifies the string value to be assigned to the object's <var>[[FieldOrFieldgroupName (AddToRecordError property)|FieldOrFieldgroupName]]</var> property. <var class="term">FieldOrFieldgroupName</var> is an optional parameter; the default value is the null string.
</td></tr>
<tr><th><var>NodeName</var></th>
<td>This name required parameter specifies the string value to be assigned to the object's <var>[[NodeName (AddToRecordError property)|NodeName]]</var> property. <var class="term">NodeName</var> is an optional parameter; the default value is the null string.
</td></tr>
<tr><th><var>NodeType</var></th>
<td>This name required parameter specifies the <var>XmlNodeType</var> enumeration value to be assigned to the object's <var>[[NodeType (AddToRecordError property)|NodeType]]</var> property. <var class="term">NodeType</var> is an optional parameter; the default value is Null.
</td></tr>
<tr><th><var>Value</var></th>
<td>This name required parameter specifies the string value to be assigned to the object's <var>[[Value (AddToRecordError property)|Value]]</var> property. <var class="term">Value</var> is an optional parameter; the default value is the null string.
</td></tr>
<tr><th><var>InputRecordNumber</var></th>
<td>This name required parameter specifies the numeric value to be assigned to the object's <var>[[InputRecordNumber (AddToRecordError property)|InputRecordNumber]]</var> property. <var class="term">InputRecordNumber</var> is an optional parameter; the default value is 0.
</td></tr></table>
 
<h4>Usage Notes</h4>
<ul>
<li><var>New</var> is available in <var class="product">[[Sirius Mods]]</var> Version 7.8 and later.
</ul>
 
 
<h2>NodeName property</h2>
 
{{Template:AddToRecordError:NodeName subtitle}}
<h4>Syntax</h4>
{{Template:AddToRecordError:NodeName syntax}}
<h4>Syntax terms</h4>
<table class="syntaxTable">
<tr><th>%string</th>
<td>A string to receive the name of a node in <var>[[AddToRecord (XmlDoc subroutine)|AddToRecord]]</var>'s method object <var>[[XmlDoc class|XmlDoc]]</var>. If the error involves a named node in the <var>XmlDoc</var> (for example, some cases when <code>[[Reason (AddToRecordError property)|Reason]] = InvalidNode</code>), this is the name of the node.
</td></tr>
<tr><th>addToRecordError</th>
<td>An <var>[[AddToRecordError_class|AddToRecordError]]</var> object.
</td></tr></table>
 
<h4>Usage Notes</h4>
<ul>
<li><var>NodeName</var> is available in <var class="product">[[Sirius Mods|Sirius Mods]]</var> Version 7.8 and later.
</ul>
 
 
<h2>NodeType property</h2>
{{Template:AddToRecordError:NodeType subtitle}}
 
<h4>Syntax</h4>
{{Template:AddToRecordError:NodeType syntax}}
<h4>Syntax terms</h4>
<table class="syntaxTable">
<tr><th>%xmlNodeType</th>
<td>A <var>[[Type_(XmlDoc/XmlNode_function)#Usage_notes|XmlNodeType]]</var> enumeration to receive the type of a node in <var>[[AddToRecord (XmlDoc subroutine)|AddToRecord]]</var>'s method object <var>[[XmlDoc class|XmlDoc]]</var>. If the error involves a node in the <var>XmlDoc</var> (for example, if <code>[[Reason (AddToRecordError property)|Reason]] = InvalidNode</code>).
</td></tr>
<tr><th>addToRecordError</th>
<td>An <var>[[AddToRecordError_class|AddToRecordError]]</var> object.
</td></tr></table>
 
<h4>Usage Notes</h4>
<ul>
<li><var>NodeType</var> is available in <var class="product">[[Sirius Mods|Sirius Mods]]</var> Version 7.8 and later.
</ul>
 
 
<h2>Reason property</h2>
{{Template:AddToRecordError:Reason subtitle}}
<h4>Syntax</h4>
{{Template:AddToRecordError:Reason syntax}}
<h4>Syntax terms</h4>
<table class="syntaxTable">
<tr><th>%addToRecordErrorReason</th>
<td>This <var>AddToRecordErrorReason</var> enumeration value describes the reason for the translation failure.
</td></tr>
<tr><th>addToRecordError</th>
<td>An <var>[[AddToRecordError_class|AddToRecordError]]</var> object.
</td></tr></table>
 
<h4>Usage notes</h4>
<ul><li>An <var class="term">AddToRecordErrorReason</var> enumeration may have one of the following values:
<dl>
<dt>InvalidNode
<dd>A node in <var>[[AddToRecord (XmlDoc subroutine)|AddToRecord]]</var>'s method object <var>[[XmlDoc class|XmlDoc]]</var> does not conform to the structure as created by the LoadFromRecord subroutine.
<dt>UntranslatableFieldName
<dd>A field name in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is not translatable to EBCDIC.
<dt>UntranslatableFieldgroupName
<dd>A fieldgroup name in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is not translatable to EBCDIC.
<dt>UntranslatableValue
<dd>A field value in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is not translatable to EBCDIC.
<dt>InvalidBase64
<dd>A string used for the base64 encoding of a field in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is not a valid base64 string.
<dt>FieldNameTooLong
<dd>A field name in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is longer than 255 characters.
<dt>FieldgroupNameTooLong
<dd>A fieldgroup name in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is longer than 255 characters.
<dt>ValueTooLong
<dd>The value of a field in <var>AddToRecord</var>'s method object <var>XmlDoc</var> that is not defined as a <var>BLOB</var> or <var>CLOB</var> field in the current file is longer than 255 characters or is longer than the defined <var>LEN</var> attribute, if the field is a fixed <var>OCCURS</var> field.
<dt>UnknownFieldName
<dd>A field name in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is not defined in the current file.
<dt>UnknownFieldgroupName
<dd>A fieldgroup name in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is not defined in the current file.
<dt>ExpectedField
<dd>A field name in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is defined as a fieldgroup in the current file.
<dt>ExpectedFieldgroup
<dd>A fieldgroup name in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is defined as a field in the current file.
<dt>ErrorAddingField
<dd>An error occurred adding a field, such as a violation of a field constraint.
<dt>ErrorAddingFieldgroup
<dd>An error occurred adding a fieldgroup, such as a file full condition.
<dt>ErrorObtainingRecord
<dd><var>AddToRecord</var> was unable to lock the record in exclusive mode.
<dt>InvalidFieldgroupID
<dd>A fieldgroup ID in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is not numeric.
<dt>InvalidCodepage
<dd>The codepage name specified on the <code>codepage</code> attribute of the <code>Record</code> element in <var>AddToRecord</var>'s method object <var>XmlDoc</var> is not a known codepage name.
<dt>ErrorAddingMaxFieldgroupID
<dd>The attempt to set the fieldgroup ID counter in the record failed; this is a very unusual condition.
<dt>InsufficientStorageForLOB
<dd>STBL, VTBL, or User Buffer storage was unavailable.<p>The <var>[[Description (AddToRecordError property)|Description]]</var> property indicates which of these is applicable.</p>
<dt>InvalidVersion
<dd>Invalid value of the <code>version</code> attribute of the <code>Record</code> element in <var>AddToRecord</var>'s method object <var>XmlDoc</var>; the only allowed value is 1.
<dt>InvalidInputRecordNumber
<dd>Invalid value of the <code>number</code> attribute of the <code>Record</code> element in <var>AddToRecord</var>'s method object <var>XmlDoc</var>; it must either be -1 or a non-negative integer.
</dl>
<li>As with all enumerations, you use the <code>ToString</code> method to convert an enumeration value to a character string whose value is the name of the enumeration value.
</ul>
 
<h4>Usage Notes</h4>
<ul>
<li><var>Reason</var> is available in <var class="product">[[Sirius Mods|Sirius Mods]]</var> Version 7.8 and later.
</ul>
 
 
<h2>UntranslatableHexValue property</h2>
{{Template:AddToRecordError:UntranslatableHexValue subtitle}}
<h4>Syntax</h4>
{{Template:AddToRecordError:UntranslatableHexValue syntax}}
<h4>Syntax terms</h4>
<table class="syntaxTable">
<tr><th>%string</th>
<td>A string to receive the hexadecimal value of the bytes that caused the exception to be thrown.  This will only be valid if the <var>[[Reason (AddToRecordError property)|Reason]]</var> property indicates the exception was due to an untranslatable [[Unicode]] character.
</td></tr>
<tr><th>addToRecordError</th>
<td>An <var>[[AddToRecordError_class|AddToRecordError]]</var> object.
</td></tr></table>
 
<h4>Usage Notes</h4>
<ul>
<li><var>UntranslatableHexValue</var> is available in <var class="product">[[Sirius Mods|Sirius Mods]]</var> Version 7.8 and later.
</ul>
 
 
<h2>Value property</h2>
{{Template:AddToRecordError:Value subtitle}}
<h4>Syntax</h4>
{{Template:AddToRecordError:Value syntax}}
<h4>Syntax terms</h4>
<table class="syntaxTable">
<tr><th>%string</th>
<td>A string to receive the value. If the error involves a value in <var>[[AddToRecord (XmlDoc subroutine)|AddToRecord]]</var>'s method object <var>[[XmlDoc class|XmlDoc]]</var> (for example, if <code>[[Reason (AddToRecordError property)|Reason]] = InvalidBase64</code>), this is the value that is in error (actually, up to 255 bytes of the value).
</td></tr>
<tr><th>addToRecordError</th>
<td>An <var>[[AddToRecordError_class|AddToRecordError]]</var> object.
</td></tr></table>
 
<h4>Usage Notes</h4>
<ul>
<li><var>Value</var> is available in <var class="product">[[Sirius Mods|Sirius Mods]]</var> Version 7.8 and later.
</ul>


This class is new in version 7.8 of the <var class="product">Sirius Mods</var>.
[[Category:System exception classes]]
[[Category:System exception classes]]

Revision as of 16:13, 9 May 2011


An AddToRecordError exception can be thrown by the AddToRecord subroutine in the XmlDoc class. It indicates that not all of the fields and/or fieldgroups from the object XmlDoc were successfully added to the current record. The various read-only properties of an AddToRecordError object (which can be set by the Catch statement) provide information about the failed operation.

This class is new in version 7.8 of the Sirius Mods.

The AddToRecordError methods

The following are the available AddToRecordError class methods.

MethodDescription
DescriptionDescription of error
FieldOrFieldgroupNameName of field or fieldgroup for which error occurred
InputRecordNumberValue of 'number' attribute from input XmlDoc
NewCreate new AddToRecordError object
NodeNameName of node in input XmlDoc for which error occurred
NodeTypeXmlNodeType of node in input XmlDoc for which error occurred
ReasonEnumerated reason for error
UntranslatableHexValueHexadecimal representation of untranslatable Unicode character, if that is reason for error
ValueValue from input XmlDoc for which error occurred

The methods in the class are described in the subsections that follow. In addition:


Description property

Description of error (AddToRecordError class)

[Introduced in Sirius Mods 7.8]

Syntax

%string = addToRecordError:Description

Syntax terms

%string A string to receive the description of the exception.
addToRecordError An AddToRecordError object.

Usage Notes

  • Description is available in Sirius Mods Version 7.8 and later.


FieldOrFieldgroupName property

Name of field or fieldgroup for which error occurred (AddToRecordError class)

[Introduced in Sirius Mods 7.8]

Syntax

%string = addToRecordError:FieldOrFieldgroupName

Syntax terms

%string A string to receive the field or fieldgroup name. If the error involves a field or fieldgroup (for example, if Reason = ErrorAddingField), this is the field or fieldgroup name.
addToRecordError An AddToRecordError object.

Usage Notes

  • FieldOrFieldgroupName is available in Sirius Mods Version 7.8 and later.


InputRecordNumber property

Value of 'number' attribute from input XmlDoc (AddToRecordError class)

[Introduced in Sirius Mods 7.8]

Syntax

%number = addToRecordError:InputRecordNumber

Syntax terms

%number A string to receive the value of the number attribute of the Record element of AddToRecord's method object XmlDoc. Assuming that the XmlDoc was created by the LoadFromRecord subroutine (or one of the methods analagous to it), this will be the number of the record from which the XmlDoc was created.
%addtoRecordError An AddToRecordError object.

Usage Notes

  • InputRecordNumber is available in Sirius Mods Version 7.8 and later.


New constructor

Create new AddToRecordError object (AddToRecordError class)

[Introduced in Sirius Mods 7.8]

Each argument to New sets the value of the corresponding property of the newly constructed AddToRecordError object.

Syntax

%addToRecordError = [%(AddToRecordError):]New( Reason= addToRecordErrorReason, - [Description= string], - [UntranslatableHexValue= string], - [FieldOrFieldgroupName= string], - [NodeName= string], - [NodeType= xmlNodeType], - [Value= string], - [InputRecordNumber= number])

Syntax terms

%addToRecordError An AddToRecordError object.
Reason This name required parameter specifies the AddToRecordErrorReason enumeration value to be assigned to the exception object's Reason property. Reason is a required parameter.
Description This name required parameter specifies the string value to be assigned to the object's Description property. Description is an optional parameter; the default value is the null string.
UntranslatableHexValue This name required parameter specifies the string value to be assigned to the object's UntranslatableHexValue property. UntranslatableHexValue is an optional parameter; the default value is the null string and, if supplied, it must be a valid hexadecimal string.
FieldOrFieldgroupName This name required parameter specifies the string value to be assigned to the object's FieldOrFieldgroupName property. FieldOrFieldgroupName is an optional parameter; the default value is the null string.
NodeName This name required parameter specifies the string value to be assigned to the object's NodeName property. NodeName is an optional parameter; the default value is the null string.
NodeType This name required parameter specifies the XmlNodeType enumeration value to be assigned to the object's NodeType property. NodeType is an optional parameter; the default value is Null.
Value This name required parameter specifies the string value to be assigned to the object's Value property. Value is an optional parameter; the default value is the null string.
InputRecordNumber This name required parameter specifies the numeric value to be assigned to the object's InputRecordNumber property. InputRecordNumber is an optional parameter; the default value is 0.

Usage Notes

  • New is available in Sirius Mods Version 7.8 and later.


NodeName property

Name of node in input XmlDoc for which error occurred (AddToRecordError class)

[Introduced in Sirius Mods 7.8]

Syntax

%string = addToRecordError:NodeName

Syntax terms

%string A string to receive the name of a node in AddToRecord's method object XmlDoc. If the error involves a named node in the XmlDoc (for example, some cases when Reason = InvalidNode), this is the name of the node.
addToRecordError An AddToRecordError object.

Usage Notes

  • NodeName is available in Sirius Mods Version 7.8 and later.


NodeType property

XmlNodeType of node in input XmlDoc for which error occurred (AddToRecordError class)

[Introduced in Sirius Mods 7.8]

Syntax

%xmlNodeType = addToRecordError:NodeType

Syntax terms

%xmlNodeType A XmlNodeType enumeration to receive the type of a node in AddToRecord's method object XmlDoc. If the error involves a node in the XmlDoc (for example, if Reason = InvalidNode).
addToRecordError An AddToRecordError object.

Usage Notes

  • NodeType is available in Sirius Mods Version 7.8 and later.


Reason property

Enumerated reason for error (AddToRecordError class)

[Introduced in Sirius Mods 7.8]

Syntax

%addToRecordErrorReason = addToRecordError:Reason

Syntax terms

%addToRecordErrorReason This AddToRecordErrorReason enumeration value describes the reason for the translation failure.
addToRecordError An AddToRecordError object.

Usage notes

  • An AddToRecordErrorReason enumeration may have one of the following values:
    InvalidNode
    A node in AddToRecord's method object XmlDoc does not conform to the structure as created by the LoadFromRecord subroutine.
    UntranslatableFieldName
    A field name in AddToRecord's method object XmlDoc is not translatable to EBCDIC.
    UntranslatableFieldgroupName
    A fieldgroup name in AddToRecord's method object XmlDoc is not translatable to EBCDIC.
    UntranslatableValue
    A field value in AddToRecord's method object XmlDoc is not translatable to EBCDIC.
    InvalidBase64
    A string used for the base64 encoding of a field in AddToRecord's method object XmlDoc is not a valid base64 string.
    FieldNameTooLong
    A field name in AddToRecord's method object XmlDoc is longer than 255 characters.
    FieldgroupNameTooLong
    A fieldgroup name in AddToRecord's method object XmlDoc is longer than 255 characters.
    ValueTooLong
    The value of a field in AddToRecord's method object XmlDoc that is not defined as a BLOB or CLOB field in the current file is longer than 255 characters or is longer than the defined LEN attribute, if the field is a fixed OCCURS field.
    UnknownFieldName
    A field name in AddToRecord's method object XmlDoc is not defined in the current file.
    UnknownFieldgroupName
    A fieldgroup name in AddToRecord's method object XmlDoc is not defined in the current file.
    ExpectedField
    A field name in AddToRecord's method object XmlDoc is defined as a fieldgroup in the current file.
    ExpectedFieldgroup
    A fieldgroup name in AddToRecord's method object XmlDoc is defined as a field in the current file.
    ErrorAddingField
    An error occurred adding a field, such as a violation of a field constraint.
    ErrorAddingFieldgroup
    An error occurred adding a fieldgroup, such as a file full condition.
    ErrorObtainingRecord
    AddToRecord was unable to lock the record in exclusive mode.
    InvalidFieldgroupID
    A fieldgroup ID in AddToRecord's method object XmlDoc is not numeric.
    InvalidCodepage
    The codepage name specified on the codepage attribute of the Record element in AddToRecord's method object XmlDoc is not a known codepage name.
    ErrorAddingMaxFieldgroupID
    The attempt to set the fieldgroup ID counter in the record failed; this is a very unusual condition.
    InsufficientStorageForLOB
    STBL, VTBL, or User Buffer storage was unavailable.

    The Description property indicates which of these is applicable.

    InvalidVersion
    Invalid value of the version attribute of the Record element in AddToRecord's method object XmlDoc; the only allowed value is 1.
    InvalidInputRecordNumber
    Invalid value of the number attribute of the Record element in AddToRecord's method object XmlDoc; it must either be -1 or a non-negative integer.
  • As with all enumerations, you use the ToString method to convert an enumeration value to a character string whose value is the name of the enumeration value.

Usage Notes

  • Reason is available in Sirius Mods Version 7.8 and later.


UntranslatableHexValue property

Hexadecimal representation of untranslatable Unicode character, if that is reason for error (AddToRecordError class)

[Introduced in Sirius Mods 7.8]

Syntax

%string = addToRecordError:UntranslatableHexValue

Syntax terms

%string A string to receive the hexadecimal value of the bytes that caused the exception to be thrown. This will only be valid if the Reason property indicates the exception was due to an untranslatable Unicode character.
addToRecordError An AddToRecordError object.

Usage Notes

  • UntranslatableHexValue is available in Sirius Mods Version 7.8 and later.


Value property

Value from input XmlDoc for which error occurred (AddToRecordError class)

[Introduced in Sirius Mods 7.8]

Syntax

%string = addToRecordError:Value

Syntax terms

%string A string to receive the value. If the error involves a value in AddToRecord's method object XmlDoc (for example, if Reason = InvalidBase64), this is the value that is in error (actually, up to 255 bytes of the value).
addToRecordError An AddToRecordError object.

Usage Notes

  • Value is available in Sirius Mods Version 7.8 and later.