文件上载

将文件发送至服务器。通常将文件上载组件与数据存储器绑定,例如,数据库或 Bean。当提交具有“文件上载”控件的页面时,会将文件存储在指定位置,例如,数据库中的列或 bean 的属性。

设计时的组件

文件上载组件拖放到页面上:

“文件上载”组件按钮

文件上载组件在页面上看起来如下所示:

设计时的“文件上载”

运行时的组件

在运行时,文件上载组件在页面上看起来如下所示:

运行时的“文件上载”

属性视图和全部属性视图

组件的“属性”视图显示可以对组件设置的最常见属性集,并且根据组件的不同,您还可以看到用于添加控件、操作或其他组件的选项。要打开“属性”视图,请单击窗口 > 显示视图 > 属性

“文件上载”组件的这些常见属性显示在“属性”视图中的 hx:fileupload验证辅助功能选项卡上。要获取完整的属性列表,请参阅全部文件上载属性表。用于验证输入和限制文件的其他配置选项位于 hx:fileuploadhx:fileupload> 验证选项卡上:

表 1. 文件上载配置选项

配置选项

描述

单击以创建/编辑定制验证代码

切换至“快速编辑”视图,以便可以为用户启动的各种事件输入脚本或代码段。

在错误消息控件中显示验证错误消息

插入与所选组件相关联的错误消息组件。如果验证失败,它将显示错误消息。

文件名

指定组件要使用的文件名。可以静态定义或链接至数据存储器。

文件类型

指定组件要使用的文件类型。可以静态定义或链接至数据存储器。

“全部属性”视图显示可以对组件设置的全部属性的表,包含可以从“属性”视图访问的那些属性。要切换至“全部属性”视图,请单击“属性”视图右上角的全部属性图标 “全部属性”图标

表 2. 全部文件上载属性

属性名称

在“属性”视图中表示为

描述

accept

允许下列类型的文件

指定组件将允许的各种文件类型,用逗号分隔。

accesskey

辅助功能 > 访问键

将单个键盘键指定为访问键。在运行时按指定的访问键可以使此组件具有焦点。在运行时按 ALT + 指定的访问键可以使此组件具有焦点,如果组件是一种按钮,则执行此组件。

alt

未表示

指定组件的备用文本。例如,如果元素在不支持表单的浏览器中和在设置为不显示图像的浏览器中不能正常呈示,则显示此备用文本。

binding

未表示

该表达式将组件的实例(通常为用户界面组件)与 Bean 属性(通常在备份文件中)绑定。

disabled

未表示

如果 disabled 设置为 true,则在运行时将显示组件,但它不起作用。如果留空,则缺省值为 false。

exclude

不允许下列文件类型

指定组件将排除的各种文件类型,用逗号分隔。

id

标识

对组件指定一个名称。它在 JSP 内应该是唯一名称。

maxlength

未表示

指定文件名和位置的最大字符长度。

readonly

未表示

指定组件的初始值不可更改。

rendered

未表示

可设置为 true 或 false:
  • false - 将不会在运行时向浏览器呈示组件。
  • true - 将呈示组件。这是缺省值。

required

值是必需的

必须指定组件。选择此项以要求用户输入值。

size

大小:宽度

指定组件的初始宽度。除文本输入组件外,宽度以像素数给出。对于文本输入组件,这个值表示字符数。

样式

样式:属性

指定组件的 CSS 样式信息,例如,style="font-size : 8pt ; color : red"。定义所选组件的属性,例如,字体和颜色。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的属性来完成。

styleClass

样式:类

当呈示此元素时要应用的以空格分隔的 CSS 样式类列表。此值必须作为生成标记上的类属性来传递。定义所选组件的类,例如,样式表。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的类来完成。

tabindex

辅助功能 > 跳进顺序索引

指定 JSP 中按跳进顺序排列的组件的位置。此值必须是 0 与 32767 之间的某个数。

title

辅助功能 > 标题

指定标题文本,它在运行时以工具提示的形式显示在浏览器中。如果未指定备用文本,则浏览器将使用标题文本作为组件的备用文本。

value

文件

指定组件要使用的文件。此值可以是字符串(文件内容将是基本 64 位编码的)、byte[] 或对象。

相关任务
定义输入字段的定制模式
使用文件上载组件
相关参考
数据表
输入
输入 - 隐藏
输入 - 密码
输入 - 文本区域
丰富文本格式区域

反馈