PointCardRW.ValidateData Method (POS for .NET v1.14 SDK Documentation)
3/2/2014
Determines whether a data sequence, possibly including one or more escape sequences, is valid for the specified station, before it calls the PrintWrite method.
Namespace: Microsoft.PointOfService
Assembly: Microsoft.PointOfService (in microsoft.pointofservice.dll)
Syntax
'Declaration
Public MustOverride Sub ValidateData ( _
data As String _
)
public abstract void ValidateData (
string data
)
public:
virtual void ValidateData (
String^ data
) abstract
public abstract void ValidateData (
String data
)
public abstract function ValidateData (
data : String
)
Parameters
- data
The data to validate. May include printable data and escape sequences.
Remarks
ValidateData causes no printing, but is used to determine the capabilities of the point card reader/writer.
ValidateData may throw a PosControlException exception with the following ErrorCodes:
Value |
Meaning |
Illegal |
Some of data is not exactly supported by the point card reader/writer. However, the service object can select valid alternatives. |
Failure |
Some data is not supported. No alternatives can be selected. |
Cases that cause Illegal to be returned are as follows:
Escape Sequence |
Condition |
Underline |
The thickness '#' is not exactly supported: the service object selects the closest supported value. |
Shading |
The percentage '#' is not exactly supported: the service object selects the closest supported value. |
Scale horizontally |
The scaling factor '#' is not supported: the service object selects the closest supported value. |
Scale vertically |
The scaling factor '#' is not supported: the service object selects the closest supported value. |
Cases that will cause Failure to be returned are as follows:
Escape Sequence |
Condition |
(General) |
The escape sequence format is not valid. |
Font typeface |
The typeface '#' is not supported. |
Bold |
Not supported. |
Underline |
Not supported. |
Italic |
Not supported. |
Reverse video |
Not supported. |
Single high and wide |
Not supported. |
Double wide |
Not supported. |
Double high |
Not supported. |
Double high and wide |
Not supported. |
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread-safe. Any instance members are not guaranteed to be thread-safe.
See Also
Reference
PointCardRW Class
PointCardRW Members
Microsoft.PointOfService Namespace
Data Characters and Escape Sequences