参数集合类XuguParameterCollection
功能
此类对象一般作为XuguCommand对象的成员出现的。为带参数的语句类提供参数支持。
说明
参数集使用完后需要用户自行清空参数链,否则可能发生上一个sql执行的参数被填充到当前sql的参数执行链的情况。
类属性介绍
属性 | 说明 |
---|---|
Count | 参数个数 |
IsFixedSize | 当前参数的类型是否是可变长度的 |
IsReadOnly | 当前参数是否是只读的 |
IsSynchronized | 是否同步的 |
类方法介绍
方法 | 参数 | 返回值 | 说明 |
---|---|---|---|
Add(object value) | value:携带参数值的参数对象 | 当前参数的位置 | 添加一个参数,携带参数值 |
Add(XuguParameter value) | value:XuguParameter的参数对象 | XuguParameter的参数对象 | 添加一个参数,参数本身为参数类型的实例对象 |
Add(string parameterName ,object value) | parameterName:参数名; value:携带参数值的参数对象 | XuguParameter的参数对象 | 添加一个参数携带参数名以及值 |
Add(string parameterName ,XuguDbType DbType) | parameterName:参数名; DdType:参数类型; size:参数长度 | XuguParameter的参数对象 | 添加一个参数携带参数名、数据类型以及长度 |
Add(string parameterName ,XuguDbType DbType , object value ParameterDirection in_out) | parameterName:参数名; DdType:参数类型; value:参数对象; in_out:参数输入输出类型 | XuguParameter的参数对象 | 添加一个参数,附带参数名、数据类型、参数值以及输入输出类型 |
AddRange(Array values) | values:参数组 | - | 在参数链中一次添加多个参数 |
AddWithValue(string parameterName ,object value) | parameterName:参数名; value:参数对象 | XuguParameter的参数对象 | 在参数链中添加一个带参数名,参数值的参数 |
Clear() | - | - | 清空参数链。XuguCommand执行完成后 ,需要执行新的sql时,一般需要清空参数链 |
IndexOf(object value) | values:参数组 | 返回值为value的参数的序号 | 在参数链中寻值为value的参数,并在找到后返回其序号,否则返回-1 |
IndexOf(string parameterName) | parameterName:参数名 | 返回名为parameterName的参数的序号 | 在参数链中寻找名为parameterName的参数,并在找到后返回其序号,否则返回-1 |
Remove(object value) | values:参数组 | - | 从参数链中移除与value 指定的相同参数 |
参数绑定示例
虚谷数据库数据类型 | C#绑定参数部分示例代码 |
---|---|
Char | t_Cmd.Parameters.Add("COL", XuguDbType.Char).Value = "DO"; |
Varchar | t_Cmd.Parameters.Add("COL", XuguDbType.VarChar).Value = "Xugu" ; |
Binary | t_Cmd.Parameters.Add("COL", XuguDbType.Binary).Value = "t_Binary"; |
VarBinary | t_Cmd.Parameters.Add("COL", XuguDbType.VarBinary).Value = "t_VarBinary"; |
Tinyint | t_Cmd.Parameters.Add("COL", XuguDbType.TinyInt).Value = 127; |
Smallint | t_Cmd.Parameters.Add("COL", XuguDbType.SmallInt).Value = 32767; |
Integer | t_Cmd.Parameters.Add("COL", XuguDbType.Int).Value = 2147418111; |
Bigint | t_Cmd.Parameters.Add("COL", XuguDbType.BigInt).Value = 9223090561878 ; |
Float | t_Cmd.Parameters.Add("COL", XuguDbType.VarChar).Value = "1.1234567"; |
Double | t_Cmd.Parameters.Add("COL", XuguDbType.Double).Value = 3.1234567890; |
Boolean | t_Cmd.Parameters.Add("COL", XuguDbType.Bool).Value = true ; |
Numeric | t_Cmd.Parameters.Add("COL", XuguDbType.Numeric).Value = 3.16 ; |
Time | t_Cmd.Parameters.Add("COL", XuguDbType.Time).Value = "9:46:32"; |
Datetime | t_Cmd.Parameters.Add("COL", XuguDbType.DateTime).Value = "2018-5-10 9:42:45"; |
Date | t_Cmd.Parameters.Add("COL", XuguDbType.Date).Value= "2018-5-10"; |
Time with time zone | t_Cmd.Parameters.Add("COL", XuguDbType.VarChar).Value = "10:34:45 +8:00"; |
Datetime with time zone | t_Cmd.Parameters.Add("COL", XuguDbType.VarChar).Value = "2018-5-14 10:34:45 +8:00" ; |
Blob | t_Cmd.Parameters.Add("COL", XuguDbType.LongVarBinary).Value = t_Blob; |
Clob | t_Cmd.Parameters.Add("COL", XuguDbType.LongVarChar).Value = t_Clob; |
IntervalYear | t_Cmd.Parameters.Add("COL", XuguDbType.VarChar).Value = "22" ; |
IntervalMonth | t_Cmd.Parameters.Add("COL", XuguDbType.VarChar).Value = "8"; |
IntervalHour | t_Cmd.Parameters.Add("COL", XuguDbType.VarChar).Value = "9"; |
IntervalMinute | t_Cmd.Parameters.Add("COL", XuguDbType.VarChar).Value = "10"; |
IntervalSecond | t_Cmd.Parameters.Add("COL", XuguDbType.VarChar).Value = "11"; |
IntervalDayToHour | t_Cmd.Parameters.Add("COL", XuguDbType.VarChar).Value = "11 23"; |
IntervalDayToMinute | t_Cmd.Parameters.Add("COL", XuguDbType.VarChar).Value = "11 23:23"; |
IntervalDayToSecond | t_Cmd.Parameters.Add("COL", XuguDbType.IntervalD2s).Value = "8025 23:23:23"; |
IntervalHourToMinute | t_Cmd.Parameters.Add("COL", XuguDbType.VarChar).Value = "23:23"; |
IntervalHourToSecond | t_Cmd.Parameters.Add("COL", XuguDbType.VarChar).Value = "23:23:23"; |
IntervalMinuteToSecond | t_Cmd.Parameters.Add("COL", XuguDbType.VarChar).Value = "23:23"; |
IntervalYearToMonth | t_Cmd.Parameters.Add("COL", XuguDbType.IntervalY2M).Value = "22-8"; |