数据输出类XuguDataReader
功能
这是一个数据集访问类,执行XuguCommand的ExecuteReader方法得到的结果集,可以使用此类对象进行浏览遍历。
说明
该对象使用read方法遍历数据集中的每一行,遍历只能单向前滚不能反向遍历。每执行一个read方法,当前行的数据发生改变,可调用该方法取得当前行的某一列的信息。
说明:
返回数据信息因数据格式不同,需要采用对应的数据类型存放,否则可能发生数据类型转化失败的情况。
类属性介绍
属性 | 说明 |
---|---|
FieldCount | 结果集的列数。为用户按列取数提供边界依据 |
IsClosed | 结果集是否已经关闭。已关闭的结果集不可以继续浏览后续数据 |
RecordsAffected | 结果集中所影响的行数。此属性一般在有结果集更新时有用 |
This[i] | 当前行的第i列的数据 |
类方法介绍
方法 | 参数 | 返回值 | 说明 |
---|---|---|---|
Read() | - | 成功:true,失败:false | 读取结果集中的一行数据到当前位置,并返回成功,若没有读到数据或者结果集已读取完毕,再次读数据时返回失败 |
IsDBNull(i) | i:结果集当前行的列号 | 为空:true,不为空:false | 判断当前行第i列是否为空 |
GetValue(i) | i:结果集当前行的列号 | 包含数据的object对象 | 取回当前行第i列的数据 |
GetTableName() | - | 包含结果集表名的字符串 | 取回当前结果集的表名 |
GetString(i) | i:结果集当前行的列号 | 成功:包含数据的字符串,失败:null | 以字符串的形式取回当前行的第i列的数据 |
GetOrdinal(string name) | name:需要查询的列名 | 成功:列序号,失败:-1 | 根据列名查询列的序号 |
GetName(i) | i:结果集当前行的列号 | 包含列名的字符串 | 取得第i列的列名 |
GetFieldType(i) | i:结果集当前行的列号 | System.Type.GetType() | 取得第i列的数据类型 |
GetInt64(i) | i:结果集当前行的列号 | Long类型的数据 | 以64位的Int长整型数据取回第i列的值 |
GetInt32(i) | i:结果集当前行的列号 | Int类型的数据 | 以Int型取数第i列的值 |
GetInt16(i) | i:结果集当前行的列号 | Short类型数据 | 以16位短整型数据取回第i列的值 |
GetFloat(i) | i:结果集当前行的列号 | Float类型数据 | 以浮点型数据取回第i列的值 |
GetDouble(i) | i:结果集当前行的列号 | Double类型数据 | 以双精度浮点型数据取回第i列的值 |
GetDecimal(i) | i:结果集当前行的列号 | Decimal类型数据 | 以C#的Decimal型数据取回第i列的值 |
GetDateTime(i) | i:结果集当前行的列号 | DateTime类型数据 | 以datetime数据类型取回第i列数据 |
GetDate(i) | i:结果集当前行的列号 | DateTime类型数据 | 以datetime的形式取回日期型数据 |
GetChars(int I,long dataindex,char[] buffer, int bufferIndex,int length) | i:结果集当前行的列号;dataindex:需要截取的字符串的起点位置;buffer:获取字符串的缓冲区;bufferIndex:buffer的长度;Length:需要截取的字符串长度 | 截取字符串的长度 | 以某个点为起点取回长度length 的第i列的字符串的部分值 |
GetChar(i) | i:结果集当前行的列号 | 包含获取到的数据的字符串 | 取字符型数据第i列的值 |
GetBytes(int I,long dataindex,byte[] buffer, int bufferIndex,int length) | i:结果集当前行的列号;dataindex:需要截取的字符串的起点位置;buffer:获取字符串的缓冲区;bufferIndex:buffer的长度;Length:需要截取的字符串长度 | 截取字节流的长度 | 以某个点为起点取回长度length的第i列的字节流的部分值 |
GetByte(i) | i:结果集当前行的列号 | Byte类型数据 | 取字节型数据第i列的值 |
GetBoolean(i) | i:结果集当前行的列号 | Bool类型数据 | 取回bool型数据第i列的值 |
Dispose() | - | - | 释放非引用型资源。减少引用型资源的引用次数 |
Close() | - | - | 关闭结果集 |