This condition is only available to users that hold a Pro License
The CodeResult condition allows you to run C# code written in the Code Section from within the script and act upon the result that the code returns. The code can be anything that you want to write as long as it returns a boolean value.
Important: This is very much a power user feature, which is why it is only available with a Pro License. In order to use the CodeResult condition you must be an experienced programmer capable of writing raw code using the C# programming language.
Command Syntax
CodeResult:[MethodName],[Parameters]
The colon after the command is compulsory. The comma character after the MethodName is only compulsory where Parameters are specified. The CodeResult validation command itself is not case sensitive, but parameters may be depending on the program, operating system, and locale.
Parameters:
MethodName: The name of the method to be executed which must have been written in the code section by the user
Parameters: Any parameters to the method line that may be required, separated by commas and surrounded by quotation marks if they are string values.
The MethodName parameter is compulsory. The Arguments parameter may or may not be required depending upon the code being run. If any required parameter is missing or invalid an error will be thrown.
Supported Data Types
The following data types are supported for parameters:
Keyword |
.Net Data Type |
Size |
Example Parameter
|
bool |
System.Boolean |
1 bit |
true |
byte |
System.Byte |
Unsigned 8-bit integer |
1 |
char |
System.Char |
16 bit |
A |
datetime |
System.DateTime |
8 bytes |
2021-06-01 00:00:00 |
decimal |
System..Decimal |
16 bytes |
16.58 |
double |
System.Double |
8 bytes |
100.00 |
float |
System.Single |
4 bytes |
75.5 |
int or int32 |
System.Int32 |
Signed 32-bit integer |
10 |
long or int64 |
System.Int64 |
Signed 64-bit integer |
123456 |
sbyte |
System.SByte |
Signed 8-bit integer |
1 |
short |
System.Int16 |
Signed 16-bit integer |
1 |
string |
System.String |
varies according to string |
"This is a string" |
uint |
System.UInt32 |
Unsigned 32-bit integer |
10 |
ulong |
System.UInt64 |
Unsigned 64-bit integer |
123456 |
ushort |
System.UInt16 |
Unsigned 16-bit integer |
10 |
The keywords are not case sensitive, so you can use Int64 or int64 and get the same result.
Example:
This example assumes that you have already created a method in the Code Section called NumberIsEven:
[Test Code Result Condition]
If:CodeResult:NumberIsEven,2,Remark:"Number is Even",Remark:"Number is Odd"
[Code]
public static bool NumberIsEven(int value)
{
return value%2 == 0 ? true : false;
}
Note: The CodeResult condition must always return a boolean value. If you try to use a method that does not provide a boolean return value then it is likely that you will get either an error or unexpected results depending on the code you have written in the script.
See Also: Code Section Reference Using Clauses Exec Run If Command ExecCode GetCodeValue