プロジェクトのすべて（またはネストした<propertyset>で指定されたサブセット）の現在のプロパティを表示します。必要に応じて、出力はファイルに送信できます。このタスクは、ant の呼び出しからデータを送り返すためにやや作為的な手段として使用できますが、実際の目的はビルドファイルのデバッグです。
| 属性 | 説明 | 必須 |
|---|---|---|
| destfile | 指定する場合、ステートメントの出力を送信するファイルの名前を示します。生成される出力ファイルは、あらゆる Java アプリケーションからプロパティファイルとして読み込むことができます。 | 否、デフォルトはログへの出力 |
| prefix | プロパティのフィルタリングに使用されるプレフィックス: このプレフィックスで始まる名前のプロパティのみがエコーされます。 | 否 |
| regex | プロパティのフィルタリングに使用される正規表現: 名前が一致するプロパティのみがエコーされます。 | 否 |
| failonerror | プロパティファイルを書き込んでいるときにエラーが発生し、この属性が有効になっている場合、BuildException がスローされ、ビルドが失敗します。無効にすると、IO エラーはログステートメントとして報告され、このタスクからの失敗なしにビルドが継続します。 |
否、デフォルトはtrue |
| format | 「text」または「xml」のいずれか。出力フォーマットを決定します。 | 否、デフォルトはtext |
Ant 1.6 以降.
propertysetを使用して、エコーするプロパティのサブセットを指定できます。propertysetを使用すると、どのプロパティを取得するかをより詳細に制御できます。属性prefixとregexは、内部的にpropertysetを使用するショートカットにすぎません。
現在のプロパティをログにレポートします。
<echoproperties/>
現在のプロパティをファイルmy.propertiesにレポートし、ファイルの作成または書き込みができなかった場合にビルドを失敗させます。
<echoproperties destfile="my.properties"/>
現在のプロパティをファイルmy.propertiesにレポートし、ファイルの作成または書き込みができなかった場合はメッセージをログに記録しますが、ビルドを続行します。
<echoproperties destfile="my.properties" failonerror="false"/>
samp>java.samp>で始まるすべてのプロパティをリストします。
<echoproperties prefix="java."/>
ネストされた<propertyset/>を使用して、samp>java.samp>で始まるすべてのプロパティをリストします。これは同等ですがより長い方法です。
<echoproperties>
<propertyset>
<propertyref prefix="java."/>
</propertyset>
</echoproperties>
名前にantを含むすべてのプロパティをリストします。
<echoproperties regex=".*ant.*"/>
<propertyset/>を使用した同等のスニペットは次のとおりです。
<echoproperties>
<propertyset>
<propertyref regex=".*ant.*"/>
</propertyset>
</echoproperties>