## LoadProperties

### Description

Load a file's contents as Apache Ant properties. This is equivalent to `<property file|resource="..."/>` except that it supports nested `<filterchain>` elements. Also if the file is missing, the build is halted with an error, rather than a warning being printed.

Note: the default value of this task's `prefixValues` attribute is different from the default value of the same attribute in the `<property>` task.

### Parameters

Attribute | Description | Required
srcFile | source file | One of these or a nested resource
resource | the resource name of the property file
encoding | encoding to use when loading the file | No
classpath | the classpath to use when looking up a resource. | No
classpathref | the classpath to use when looking up a resource, given as reference to a `<path>` defined elsewhere.. | No
prefix | Prefix to apply to loaded properties; a "." is appended to the prefix if not specified. Since Ant 1.8.1 | No
prefixValues | Whether to apply the prefix when expanding the right hand side of the properties. Since Ant 1.8.2 | No (default=`true`)

### Parameters specified as nested elements

#### any resource or single element resource collection

The specified resource will be used as src. Since Ant 1.7

#### FilterChain

#### classpath

for use with the resource attribute.

### Examples

        <loadproperties srcFile="file.properties"/>

or

        <loadproperties>
          <file file="file.properties"/>
        </loadproperties>

Load contents of file.properties as Ant properties.

        <loadproperties srcFile="file.properties">
          <filterchain>
            <linecontains>
              <contains value="import."/>
            </linecontains>
          </filterchain>
        </loadproperties>

Read the lines that contain the string "import." from the file "file.properties" and load them as Ant properties.

        <loadproperties>
          <gzipresource>
            <url url="http://example.org/url.properties.gz"/>
          </gzipresource>
        </loadproperties>

Load contents of http://example.org/url.properties.gz, uncompress it on the fly and load the contents as Ant properties.