檔案上載

傳送檔案至伺服器。檔案上載元件通常是連結到資料儲存體,例如資料庫或 Bean。 若送出含有檔案上載控制項的頁面時,檔案會儲存在指定的位置(例如,資料庫的直欄或 Bean 的內容)。

設計時的元件

檔案上載元件拖放到頁面上:
「檔案上載」元件按鈕

頁面中的檔案上載元件看起來與下面類似:
設計時的「檔案上載」

執行時期的元件

在執行時期,頁面中的檔案上載元件看起來與下面類似:
執行時期的「檔案上載」

「內容及所有屬性」視圖

元件的「內容」視圖會顯示您可以用來設定元件的最常用屬性集,而且針對不同的元件,您也會看到新增控制項、動作或其他元件的選項。若要開啟「內容」視圖,請按一下「視窗 > 顯示視圖 > 內容」;然而依預設會開啟該視圖。

「檔案上載」元件的這些共同屬性顯示在「內容」視圖的 hx:fileupload驗證協助工具標籤中。 如需完整的屬性清單,請參閱所有檔案上載屬性表格。用以驗證輸入及限制檔案的其他配置選項是位在 hx:fileuploadhx:fileupload>驗證標籤上:

表 1. 檔案上載配置選項

配置選項

說明

按一下來建立/編輯自訂驗證程式碼

切換至「快速編輯」視圖,以便為各種使用者起始的事件輸入 Script 或程式碼片段。

在錯誤訊息控制中顯示驗證錯誤訊息

插入與選取的元件相關聯的錯誤訊息控制元件。這樣就會在驗證失敗時顯示錯誤訊息。

檔案名稱

指定元件所要使用之檔案的名稱。可以用靜態的方式定義,或者鏈結到資料儲存體。

檔案類型

指定元件要使用的檔案類型。可以用靜態的方式定義,或者鏈結到資料儲存體。

「所有屬性」視圖會顯示您可以在元件上設定之所有屬性的表格,包括您可以從「內容」視圖來存取的那些屬性。若要切換至「所有屬性」視圖,請按一下「內容」視圖右上角的「所有屬性」圖示 「所有屬性」圖示

表 2. 所有檔案上載屬性

屬性名稱

顯示在「內容」視圖中的排列依據

說明

accept

容許下列檔案類型

指定元件將容許的檔案類型,並以逗點區隔。

accesskey

協助工具>存取鍵

指定單一鍵盤按鍵作為存取鍵。在執行時期按下指定的存取鍵時, 就會將焦點移至這個元件。

alt

沒有顯示

指定元件的替代文字。當元素無法正常呈現時,就會顯示;例如:不支援表單的瀏覽器,以及設定為不顯示影像的瀏覽器。

binding

沒有顯示

代表這個元件的 UIComponent,通常是在支持的檔案中。

disabled

沒有顯示

如果 disabled 設為 true,在執行時期會顯示該元件,但無法使用。如果保留空白,預設值是 false。

exclude

不容許下列檔案類型

指定元件將排除的檔案類型,並以逗點區隔。

id

ID

指派元件的名稱。應該是 JSP 內的唯一名稱。

maxlength

沒有顯示

指定檔名及位置的字元長度上限。

readonly

沒有顯示

指定元件值不能從其起始值進行變更。

rendered

沒有顯示

可以設成 true 或 false:
  • false - 執行時期不會將元件呈現在瀏覽器中。
  • true - 將會呈現元件。

required

必須輸入值

必須指定元件。勾選這個方框時,使用者必須輸入一個值。

size

大小:寬度

指定元件的起始寬度。 以像素來提供寬度,但其值參照字元數的文字輸入元件除外。

style

樣式:內容

指定元件的 CSS 樣式資訊(如 style="font-size : 8pt ; color : red")。定義已選取的元件的內容(例如字型和顏色)。 這可以用手動方式來完成,或者按一下按鈕,然後從視窗內選取想要的內容。

styleClass

樣式:類別

當呈現這個元素時,所要套用的 CSS 樣式類別清單,各個類別之間是用空格加以區隔。 這個值必須作為產生的標記之 "class" 屬性來傳遞。定義已選取的元件的類別(例如樣式表)。 這可以用手動方式來完成,或者按一下按鈕,然後從視窗內選取想要的「類別」。

tabindex

協助工具>欄標次序索引

指定元件在 JSP 內的定位次序位置。這個值必須是 0 和 32767 之間的數字。

title

協助工具>標題

指定執行時期在瀏覽器中顯示成工具要訣的標題文字。

value

檔案

指定元件要使用的檔案。

相關概念
建立使用 JavaServer Faces 的資料存取 Web 應用程式
相關工作
建立 Faces 應用程式 - 概觀
相關參考
Faces 元件參照
Faces 元件的屬性
顯示錯誤
讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.