Functions.FieldPut 方法 | |
通过位置设置字段的值。
命名空间:
XSharp.RT
程序集:
XSharp.RT (在 XSharp.RT.dll 中) 版本:2.22 GA
语法 FUNCTION FieldPut(
nFieldPos AS USUAL,
uNewValue AS USUAL
) AS USUAL
public static __Usual FieldPut(
__Usual nFieldPos,
__Usual uNewValue
)
查看代码参数
- nFieldPos
- 类型:__Usual
字段在数据库文件结构中的位置。 - uNewValue
- 类型:__Usual
要赋给字段的值。
此表达式的数据类型必须与字段的数据类型匹配。
返回值
类型:
__Usual
赋给字段的值。
如果
nFieldPos 不对应数据库文件中任何字段的位置,FieldPut() 将生成错误。
例外情况是在 XBase++ 方言中,无效的
nFieldPos 不会生成异常,而是返回 NIL。
备注
FieldPut() 允许您使用字段在数据库文件结构中的位置而不是字段名来设置字段的值。在通用数据库服务函数中,这允许(除其他外)在不使用宏运算符的情况下设置字段值。
注意:FieldPut() 可用于 BLOB 字段(即与 BLOB 文件关联的备注字段),前提是字段长度不超过 64 KB。
默认情况下,此函数在当前选定的工作区上操作。
可以通过在别名表达式中指定来使其在未选定的工作区上操作。
共享模式:
对于共享数据库,此函数需要记录锁定。
示例
此示例比较了 FieldPut() 与使用宏运算符设置字段值的功能等效代码:
1
2FName := FIELDNAME(nFieldPos)
3_FIELD->&FName := FVal
4
5FieldPut(nFieldPos, FVal)
参见