<x:getColumn>

x:getColumn 動作用來取得直欄值。您可以明確指定哪個直欄、在哪一列、在哪個 SelectProcedureCall,也可以採用這些選項預設值,如以下的 index、row 和 name 屬性所述。如果動作發生在 x:repeat 的主體內,這就尤其有用。

語法

<x:getColumn 	name = "target bean name"
			colName = "name"
			index = "number"
			row = "rowNumber"	
			nullToken = "string" />

x:getColumn 元素有下列屬性:

name
這是要從中取得直欄值的結果集所在之 DBSelectDBProcedureCall Bean 的名稱。這個值會區分大小寫,且必須符合在範圍內的 Select 或 ProcedureCall 變數。除非動作(直接或間接)是在已指定了 name 屬性的 x:repeat 主體內,否則便需要這個屬性。在這個情況下,name 屬性的預設值是最接近的含括的 x:repeat 中所指定的相同值。
colName
直欄的名稱。 這個值會區分大小寫。 這個屬性是選用的。 它沒有預設值。 如果指定了 over="columns" 的 x:repeat 主體內沒有這個動作,您就必須指出含有這個屬性或 index 屬性的直欄。同時明確指定兩者是錯誤的。
index
直欄的索引。 第一個直欄的索引是 1。這個屬性是選用的。 如果指定了 over="columns" 的 x:repeat 主體內有這個動作,屬性預設值就是 x:repeat 的索引變數值。如果沒有的話,您必須指出含有這個屬性或 colName 屬性的直欄。 同時明確指定兩者是錯誤的。
row
要從中取得直欄值的列號。 第一列的號碼是 1。 這個屬性是選用的。 如果沒有指定的話,預設值會隨著這個動作是否在指定了 over="rows" 的 x:repeat 主體內而不同。如果是如此,就會使用該 x:repeat 的索引變數值。如果不是如此,就會使用結果集的現行列之索引。
nullToken
指定在 JSP 輸出中,要用來代表資料庫空值的字串值,會區分大小寫。

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

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