檔案清單

檔案清單是明確命名的檔案清單。檔案集作為篩選器,只傳回檔案系統中存在的檔案,並符合指定的模式,檔案清單則用於指定可能存在或不存在的檔案。多個檔案指定為檔案清單,相對於指定的目錄,不支援萬用字元擴充(包含萬用字元的檔名將不變地包含在清單中)。檔案清單可以出現在支援此功能的任務中,或作為獨立類型。

屬性 說明 必要
dir 此檔案清單的基本目錄。
files 檔案名稱清單。這是以空白或逗號分隔的檔案名稱清單。 是,除非有巢狀檔案元素
refid 使此檔案清單成為對其他地方定義的檔案清單參考。如果指定,則不允許其他屬性或巢狀元素。

巢狀元素:檔案

自 Apache Ant 1.6.2 起

這表示檔案名稱。巢狀元素允許包含空白和逗號的檔名。

屬性 說明 必要
名稱 檔案名稱。

範例

<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>

與上述範例相同的檔案。