AppFramework1.0数据库访问组件使用说明(四)基础数据类型

AppFramework

墨衍会员 · AI 创作全网分发码龄19年

关注

原创最新推荐文章于 2026-06-21 16:30:40 发布 1.3k 阅读 AI 写同款· GEO 优化 ›

【工业软件开发学习——AnyCAD篇】模式(Schema)、组件(Component)与参数化对象(Part II) 基于AnyCAD实现属性修改与关联更新阅读详情

1.1 基础数据类型

1.1.1 有关DBValue

为了规避IBatisNet的空值问题，AppFramework不使用C#基本类型来构造实体类。AppFramework对C#基本类型作了简单封装，增加了一个是否有值的属性来标志字段值是否非空。

每一种基本的C#类型都有对应的DBValue对其进行封装。

C#类型	DBValue类型	数据库类型
byte	ByteValue	数字类型
short	ShortValue	数字类型
int	IntValue	数字类型
long	LongValue	数字类型
sbyte	SByteValue	数字类型
ushort	UShortValue	数字类型
ulong	ULongValue	数字类型
uint	UIntValue	数字类型
DateTime	DateTimeValue	日期时间
string	StringValue	Varchar/NVarchar 或 Text/CLOB类型
float	FloatValue	数字类型
double	DoubleValue	数字类型
decimal	DecimalValue	数字类型、金额
byte[]	BLOBValue	BLOB类型

1.1.2 DBValue的属性方法

在AppFramework里， DBValue主要用于构造数据库的表实体类。代码生成器为每个数据表生成一个实体类，为每个表字段生成一个子类化的DBValue属性，并自动实现实体类的构造、赋值。测试数据表明，虽然DBValue构造的实体类比用C#基本类型构造的实体类要“重”一些，但其构造对象的性能比IBatis用反射的方式构造对象的性能还是高很多。

下表简单列举了DBValue的基本属性和方法：

属性/方法	类型	说明
HasValue	Bool	标志字段是否有值，构造时初始化为false
Object	Object	获取或设置字段内部封装的值，如果 HasValue 为 false, 获取时得到 null
DBObject	Object	获取或设置字段内部封装的值，如果 HasValue 为 false, 获取时得到 DBNull.Value; 如果设置 DBNull，则 HasValue 改变为 false;
Value	封装的C#类型	获取字段值，HasValue 为 false 时获取 Value 值将获得所封装类型的默认值
ToString()	String	显示为文本，如果HasValue为false，则返回string.Empty
Clear()	Void	把HasValue设置为false，但清除Value值

例如，IntValue 封装了 int类型的数据库字段，IntValue.HasValue表示是否有值，如果没有值访问IntValue.Value属性会得到int的默认值。对无值的IntValue调用ToString()会得到空字符串。

正确的用法应该是先通过HasValue判断是否有值，然后在访问Value获取值。

public BasUser GetUser(string fields, int id)

{

// 获得dao

IBasUserDAO dao = DAOManager.Default.GetDAO<IBasUserDAO>();

// 获得数据库会话

using (IDBSession session = DBSessionManager.Default.GetSession())

{

return dao.Get(session, fields, id);//返回得到的实体，如果未找到记录，返回null

}

public void ShowUser(int userID)

{

BasUser user = GetUser(userID);

if (user != null)

{

txtName.Text = user.Name.ToString();

txtAge.Text = user.Age.ToString();

}
}

1.1.3 有关DBField

DBField封装的基本目的是表达C#原始类型的所不能表达的“空值”、“默认值”、“表达式”等信息，其结构为“字段名—操作符—表达式”，在AppFramework中主要用于插入和更新数据库记录时为数据库字段赋值或表达式。经过扩展，也适用于各一些表达 “字段名—操作符—表达式”结构的SQL语句片段，例如“字段名 in (select … from)”这样的子查询。

DBField封装了各种通用的数据库字段类型，如下表：

C#类型	DBField类型	数据库类型
Object	DBField	通用类型
Byte	ByteField	数字类型
Short	ShortField	数字类型
Int	IntField	数字类型
Long	LongField	数字类型
Sbyte	SByteField	数字类型
Ushort	UShortField	数字类型
Ulong	ULongField	数字类型
uint	UIntField	数字类型
DateTime	DateTimeField	日期时间
string	StringField	Varchar/NVarchar
string	TextField	Text/CLOB类型
float	FloatField	数字类型
double	DoubleField	数字类型
decimal	DecimalField	数字类型、金额
byte[]	BLOBField	BLOB类型

注意：DBField比DBValue多了对两种基础类型的封装，一个是DBField对object的封装，另一个是TextField对CLOB/TEXT大文本字段的封装。

1.1.4 DBField的属性方法

下表简单列举了DBField的基本用法：

属性/方法	类型	说明
FieldName	string	获取或设置字段名
Operator	DBOperator	获取或设置字段操作符，例如大于、小于、等于、in、like……等常用操作符，默认为 Equal
Value	封装的C#类型	获取字段值，HasValue 为 false 时获取 Value 值将获得所封装类型的默认值
Expression	string	获取或设置字段表达式
Flag	DBFieldFlag	获取字段值状态标志，当标志值为NotSet时表示未设置值，标志值为Value 表示此对象的Value属性有效; Expression表示此对象的Expression有效。默认为 NotSet。
DataType	DataType	获取或设置字段值类型
AsObject	object	以 object 方式获取或设置字段值，如果 Flag为 NotSet, 获取时得到 null
SelectStatement	SelectStatement	获取或设置字段的子查询表达式
SetDefault()	void	设置字段为其默认值
SetNull()	void	设置字段为空值
Clear()	void	清除字段值或表达式，把Flag设置为NotSet
ToString()	string	已重载。若Flag为NotSet，返回string.Empty。若Flag为Value，则返回Value.ToString()。若Flag为Expression，则返回Expression。

为了方便使用，提供了几个静态方法快速创建各种DBField：

方法	返回值	说明
CreateExpression	DBField	创建一个表达式，有多个重载，可以对各个属性进行设置。 string fieldName：字段名 DataType t：字段类型 DBOperator op：表达式的操作符 string expression：表达式
CreateDefault	DBField	创建一个默认值字段
CreateNull	DBField	创建一个空值字段
Create	DBField	虚方法，子类将重载，创建一个子类DBField