echoproperties

說明

顯示專案中所有目前的屬性（或由巢狀 <propertyset> 指定的子集）。如果需要，輸出可以傳送至檔案。此任務可用作從 ant 呼叫傳回資料的某種人為方式，但實際上是為了偵錯建置檔案。

參數

屬性 說明 必要
destfile 如果指定，此值會指出要將陳述式輸出傳送至的檔案名稱。產生的輸出檔案與任何 Java 應用程式相容，可作為屬性檔案載入。 否；預設輸出至記錄檔
prefix 用於過濾屬性的字首：只有名稱以此字首開頭的屬性才會被回顯。 否
regex 用於過濾屬性的正規表示式：只有名稱符合此正規表示式的屬性才會被回顯。 否
failonerror 如果在將屬性寫入檔案時發生錯誤，且此屬性已啟用，則會擲回 BuildException，導致建置失敗。如果已停用，則 IO 錯誤會報告為記錄檔陳述式，且建置會繼續進行，不會因為此任務而失敗。 否；預設為 true
format 下列其中之一：text 或 xml。決定輸出格式。 否；預設為 text

指定為巢狀元素的參數

propertyset

自 Ant 1.6 起.

您可以使用 propertyset 指定要回顯的屬性子集。使用 propertyset 可以更進一步控制要擷取哪些屬性。屬性 prefix 和 regex 只是在內部使用 propertyset 的捷徑。

範例

將目前的屬性報告至記錄檔。

<echoproperties/>

將目前的屬性報告至檔案 my.properties，如果無法建立或寫入檔案，則建置失敗。

<echoproperties destfile="my.properties"/>

將目前的屬性報告至檔案 my.properties，如果無法建立或寫入檔案，則記錄訊息，但仍允許建置繼續進行。

<echoproperties destfile="my.properties" failonerror="false"/>

列出所有以 java. 開頭的屬性。

<echoproperties prefix="java."/>

使用嵌套的 <propertyset/> 列出所有以 java. 開頭的屬性，這是一種相同但較長的方法。

<echoproperties>
  <propertyset>
    <propertyref prefix="java."/>
  </propertyset>
</echoproperties>

列出所有名稱中包含 ant 的屬性。

<echoproperties regex=".*ant.*"/>

使用 <propertyset/> 的等效片段為

<echoproperties>
  <propertyset>
    <propertyref regex=".*ant.*"/>
  </propertyset>
</echoproperties>