LoadFile

説明

もっぱらファイルに対して動作し、利便性のためにsrcFile 属性を提供する、loadresource の特殊化。 encoding が指定されていない場合、現在のロケールのエンコーディングが使用されます。

リソースコンテンツが空の場合（おそらく filterchain の処理後）、プロパティは設定されません。

パラメーター

属性 説明 必須
srcFile ソースファイル はい
property 保存するプロパティ はい
encoding ファイルをロードするときに使用されるエンコーディング いいえ
failonerror 失敗時にビルドを停止するかどうか いいえ。デフォルトは true。
quiet 診断メッセージを表示しない（Apache Ant が -verbose または -debug スイッチとともに呼び出された場合を除きます）。エラーが反映されるように終了ステータスを変更することもありません。これを true に設定すると、failonerror が false に設定されます。Ant 1.7.0 以降。 いいえ。デフォルトは false。

LoadFile タスクは入れ子になった FilterChain をサポートします。

例

ファイルmessage.txt をプロパティmessage にロードします。 <echo> はこれを印刷できます。

<loadfile property="message"
          srcFile="message.txt"/>

上記は次と同一です。

<loadresource property="message">
    <file file="message.txt"/>
</loadresource>

ラテン-1 エンコーディングを使用してファイルをロードします。

<loadfile property="encoded-file"
          srcFile="loadfile.xml"
          encoding="ISO-8859-1"/>

ファイルをロードします。ファイルが見つからない場合でも失敗しません（ただしメッセージは印刷されます）。

<loadfile property="optional.value"
          srcFile="optional.txt"
          failonerror="false"/>

別のタスク（この場合は mail）のパラメーターとして使用できるプロパティをロードし、これらの行をマージしてこれが確実に実行されるようにします。

<loadfile property="mail.recipients"
          srcFile="recipientlist.txt">
    <filterchain>
        <striplinebreaks/>
    </filterchain>
</loadfile>

XML ファイルをプロパティにロードし、その処理中にファイルで宣言されたすべてのプロパティを展開します。

<loadfile property="system.configuration.xml"
          srcFile="configuration.xml">
    <filterchain>
        <expandproperties/>
    </filterchain>
</loadfile>