<x:column>

x:column 動作用來指定直欄的更新或插入所應設定的值。您也可以利用 x:setColumn 動作來設定直欄值,但該動作可用在其目標 DBSelect Bean 範圍內的任何位置,而這個動作只能發生在 x:updateRowx:insertRow 的主體內。

語法

<x:column	 	colName = "name"
			index = "number"
			value = "value"
			nullToken = "string" />

x:column 元素有下列屬性:

colName
直欄的名稱。 這個值會區分大小寫。 您必須指定這個屬性或索引屬性。您不應同時指定這兩者。
index
直欄的索引。 第一個直欄的索引是 1。 您必須指定這個屬性或 colName 屬性。您不應同時指定這兩者。
value
直欄值。 您提供的值可以是能得出任何 Java™ 物件的表示式。這個屬性是必要的。

如果您提供的值是字串,這個動作會將它轉換成直欄的適當 Java 物件類型。輸入的大小寫會保留下來。如果值是任何其他種類的物件,它必須是該直欄的正確類型,否則會發生錯誤。

我們提供了兩個特殊值,您可以利用它來設定這個屬性:&empty 和 &null,它們分別代表空字串和空值物件參照。 指定 value="" 相當於指定 value="<%=2.23 nullObj %>,其中 nullObj 是空值物件參照。

nullToken
指定要當作資料庫空值來處理的字串值,會區分大小寫。 如果 value 屬性含有這個字串,在資料庫中,就會將直欄設為空值。

這個屬性是選用的。 如果您忽略它的話,就會使用相關的 x:select 動作之相同屬性的值。如果兩個位置都略過屬性的話,預設值就是 &empty。(&empty 是一個類似於 HTML 字元實體的特殊值,在這個屬性中,被識別為代表空字串。) 請參閱空值,以取得空值表示法的詳細資料。

範例

請參閱 <x:updateRow> 中的範例。

使用條款 | 讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.