FieldSpec 类

创建一个字段规范，该规范包含有关数据元素（如数据库字段和窗口控件）的通用数据类型信息。

继承层次

Object
  FieldSpec
    DateFS
    IntegerFS
    LogicFS
    NumberFS
    StringFS

命名空间： XSharp.VO.SDK
程序集： XSharp.VOSystemClasses (在 XSharp.VOSystemClasses.dll 中) 版本：2.22 GA

语法

[TypesChangedAttribute]
 CLASS FieldSpec

[TypesChangedAttribute]
public class FieldSpec

FieldSpec 类型公开以下成员。

构造函数

	名称	说明
	FieldSpec(String, __Usual, UInt32, UInt32)	构造一个字段规范。
	FieldSpec(HyperLabel, __Usual, UInt32, UInt32)	构造一个字段规范。

属性

	名称	说明
	Decimals	表示定义给此字段规范的小数位数的数值。
	HyperLabel	连接到此字段规范的超标签。
	Length	表示定义给此字段规范的长度的数值。
	Maximum	表示此字段规范的范围验证中的最大值的数值。
	Minimum	表示此字段规范的范围验证中的最小值的数值。
	MinLength	表示此字段规范的新最小长度验证的数值。
	MinLengthHL	最小长度验证失败时的错误消息。
	Nullable	字段是否可为空？
	Picture	表示定义给此字段规范的图片子句的字符串。它由 FieldSpec:Transform() 方法使用。
	RangeHL	范围验证失败时的错误消息。
	Required	指示字段是否必需的逻辑值（TRUE 或 FALSE）。
	RequiredHL	必需验证失败时的错误消息。
	Status	在验证请求之后（有关详细信息，请参阅 FieldSpec:PerformValidations()），此字段包含描述验证结果的 HyperLabel 对象，如果验证通过，则为 NULL_OBJECT。
	UsualType	表示定义给此字段规范的数据类型的常量:
	Validation	设置此字段规范的验证规则的代码块。
	ValidationHL	验证失败时的错误消息。
	ValType	表示此字段规范定义的数据类型的单字符字符串：

方法

	名称	说明
	_SetType
	AsString	返回定义给此字段规范的超标签的标题；如果未定义标题，则返回定义给超标签的名称。
	PerformValidations	测试指定值是否通过此字段规范的所有验证规则。
	SetLength	为此字段规范设置新的长度和新的超标签诊断以进行长度检查。
	SetMinLength	为此字段规范设置新的最小长度验证和新的超标签诊断以进行最小长度检查。
	SetRange	为此字段规范设置新的范围验证和新的超标签诊断以进行范围检查。
	SetRequired	为此字段规范设置新的必需验证和新的超标签诊断以进行必需检查。
	SetType	为此字段规范设置新的数据类型和新的超标签诊断以进行数据类型检查。
	SetValidation	为此字段规范设置新的验证规则和新的超标签诊断以进行验证规则检查。
	Transform	将指定值转换为字符串，格式化为此字段规范的图片子句。
	Val	根据此字段规范定义的数据类型，将字符串转换为值。
	Validate	一个可替换的方法，用于执行验证。标准实现会评估通过 FieldSpec:SetValidation() 指定的代码块。

备注

FieldSpec 对象包含许多与字段相关的属性。具体来说，可以为以下内容定义 FieldSpec 对象：由于这两种类型最终都适用于字段，因此字段规范的属性仅以字段的术语描述（即，不包括窗口控件）。

提示：
字段规范对应于有时称为“元素定义”、“域”或“抽象数据类型”的内容。

字段规范包含以下属性：

属性	描述
Decimals	字段中的小数位数（仅限数字）
Diagnostics	每个验证规则的超标签。请注意，超标签不仅包含诊断消息，还包含帮助上下文，以便在验证失败后提供上下文相关的帮助。
HyperLabel	有关字段的信息：其名称、标题、描述和帮助上下文
Length	字段的长度
Min,Max	字段中允许的数据范围
MinLength	字段中允许的最小字符数（例如，STATE 字段可以定义为长度和最小长度为 2，而 PASSWORD 可能具有长度为 10 和最小长度为 4）
Picture	用于格式化字段的图片子句。这是一个标准的 Xbase 图片子句，例如 @! 或 999-99-9999。
Status	描述验证测试结果的 HyperLabel 对象（如果验证通过，则为 NIL）
Type	字段的基础存储类型（数字、字符串、逻辑、日期或备注）
Validation	设置字段验证规则的代码块（即，必填字段、数据类型合规性、范围合规性等）。还请注意，FieldSpec 子类可以具有 Validation() 方法，该方法会覆盖此代码块。

参见