文件列表

文件列表是明确命名的文件列表。与文件集充当过滤器，仅返回文件系统中存在且与指定模式匹配的文件不同，文件列表对于指定可能存在也可能不存在的文件很有用。多个文件指定为相对于指定目录的文件列表，不支持通配符扩展（包含通配符的文件名将按原样包含在列表中）。文件列表可以出现在支持此功能的任务中，也可以作为独立类型出现。

属性 描述 必需
dir 此文件列表的基目录。 是
files 文件名列表。这是一个由空格或逗号分隔的文件名列表。 是，除非存在嵌套文件元素
refid 使此filelist成为对在其他地方定义的filelist的引用。如果指定，则不允许其他属性或嵌套元素。 否

嵌套元素：file

自 Apache Ant 1.6.2 起

这表示一个文件名。嵌套元素允许包含空格和逗号的文件名。

属性 描述 必需
name 文件的名称。 是

示例

<filelist
    id="docfiles"
    dir="${doc.src}"
    files="foo.xml,bar.xml"/>

文件 ${doc.src}/foo.xml 和 ${doc.src}/bar.xml。请注意，这些文件可能（尚未）实际存在。

<filelist
    id="docfiles"
    dir="${doc.src}"
    files="foo.xml
           bar.xml"/>

与上面的示例相同的文件。

<filelist refid="docfiles"/>

与上面的示例相同的文件。

<filelist
    id="docfiles"
    dir="${doc.src}">
    <file name="foo.xml"/>
    <file name="bar.xml"/>
</filelist>

与上面的示例相同的文件。