x:setColumn 操作用来设置列的值。可以显式地指定哪一列、哪一行以及在哪一个 Select 中,也可以让这些选项具有缺省值,如下面的 index、row 和 name 属性所述。如果操作发生在 x:repeat 的主体内,这就特别有用。
如果在除当前行之外的任何行中设置值,将首先对数据库应用当前行中所作的任何更改。操作结束时,您用来设置值的行成为当前行。
也可以使用 x:column 操作设置列值,但该操作只能发生在 x:updateRow 或 x:insertRow 的主体内,而 x:setColumn 可以在目标 DBSelect Bean 的作用域内的任何位置使用。
<x:setColumn name = "target bean name" colName = "name" index = "number" row = "rowNumber" value = "value" nullToken = "string" />
x:setColumn 元素具有下列属性:
如果提供的值为字符串,则此操作会将它转换为适合于该列的 Java 对象类型。保留您输入的大小写不变。如果值为任何其他类型的对象,则该值必须是对于该列正确的类型,否则会出错。
我们提供了两个可用来设置此属性的特殊值:&empty 和 &null,它们分别代表空字符串和空对象引用。指定 value="" 等价于指定 value="<%=2.23 nullObj %>",其中 nullObj 是空对象引用。
此属性是可选的。如果省略它,则使用相关联的 x:select 操作上的同一属性的值。如果在两个位置中都省略此属性,则缺省值为 &empty。&empty 是一个特殊值,类似于 HTML 字符实体, 在此属性中,将其识别为代表空字符串。有关空值表示法的更多信息,请参阅空值。