PointCardRW.ValidateData Method

2/27/2008

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