Summary

Parses NAnt properties and expressions

Assembly

NAnt.Core.dll

Namespace

NAnt.Core.Filters

Interfaces

IDisposable

Base Types

graph BT Type-->Base0["Filter"] click Base0 "/api/NAnt.Core.Filters/Filter" Base0-->Base1["ChainableReader"] click Base1 "/api/NAnt.Core.Filters/ChainableReader" Base1-->Base2["Element"] click Base2 "/api/NAnt.Core/Element" Base2-->Base3["Object"] Type-.->Interface0["IDisposable"] Type["ExpandProperties"] class Type type-node

Syntax

[ElementName("expandproperties")]
public class ExpandProperties : Filter, IDisposable

Examples

Replace all properties with their corresponding values.

<expandproperties />

Remarks

This filter parses any NAnt properties or expressions found in its input, inlining their values in its output.

Note: Due to limitations on buffering, expressions longer than 2048 characters are not guaranteed to be expanded.

Filters are intended to be used as a element of a NAnt.Core.Filters.FilterChain.

Attributes

Type	Description
ElementNameAttribute	Indicates that class should be treated as a NAnt element.

Properties

Name	Value	Summary
Base	bool	Gets a value indicating if the reader is backed by a stream in the chain. Inherited from ChainableReader
CustomXmlProcessing	bool	Gets a value indicating whether the element is performing additional processing using the `NAnt.Core.Element.XmlNode` that was used to initialize the element. Inherited from Element
IfDefined	bool	If `true` then the filter will be used; otherwise, skipped. The default is `true`. Inherited from Filter
Location	Location	Gets or sets the location in the build file where the element is defined. Inherited from Element
Name	string	Gets the name of the XML element used to initialize this element. Inherited from Element
NamespaceManager	XmlNamespaceManager	Gets or sets the `System.Xml.XmlNamespaceManager`. Inherited from Element
Parent	Object	Gets or sets the parent of the element. Inherited from Element
Project	Project	Gets or sets the `NAnt.Core.Element.Project` to which this element belongs. Inherited from Element
Properties	PropertyDictionary	Gets the properties local to this `NAnt.Core.Element` and the `NAnt.Core.Element.Project`. Inherited from Element
UnlessDefined	bool	Opposite of `NAnt.Core.Filters.Filter.IfDefined`. If `false` then the filter will be executed; otherwise, skipped. The default is `false`. Inherited from Filter
XmlNode	XmlNode	Gets or sets the XML node of the element. Inherited from Element

Methods

Name	Value	Summary
Chain(ChainableReader)	void	Makes it so all calls to Read and Peek are passed the ChainableReader passed as a parameter. Inherited from ChainableReader
Chain(TextReader)	void	Makes it so all calls to Read and Peek are passed the TextReader passed as a parameter. Inherited from ChainableReader
Close()	void	Closes the reader. Inherited from ChainableReader
CopyTo(Element)	void	Copies all instance data of the `NAnt.Core.Element` to a given `NAnt.Core.Element`. Inherited from Element
Dispose()	void	Calls close and suppresses the finalizer for the object. Inherited from ChainableReader
GetAttributeConfigurationNode(FrameworkInfo, string)	XmlNode	Locates the XML node for the specified attribute in the project configuration node. Inherited from Element
GetAttributeConfigurationNode(XmlNode, FrameworkInfo, string)	XmlNode	Inherited from Element
GetLocation()	Location	Retrieves the location in the build file where the element is defined. Inherited from Element
Initialize()	void	Derived classes should override to this method to provide extra initialization and validation not covered by the base class. Inherited from Element
Initialize(XmlNode)	void	Performs default initialization. Inherited from Element
InitializeBuildElement(Element, XmlNode, Element, Type)	Element	Initializes the build element. Inherited from Element static
InitializeElement(XmlNode)	void	Derived classes should override to this method to provide extra initialization and validation not covered by the base class. Inherited from Element
InitializeFilter()	void	Called after construction and after properties are set. Allows for filter initialization.
InitializeXml(XmlNode, PropertyDictionary, FrameworkInfo)	void	Initializes all build attributes and child elements. Inherited from Element
Log(Level, string)	void	Logs a message with the given priority. Inherited from Element
Log(Level, string, Object[])	void	Logs a message with the given priority. Inherited from Element
Peek()	int	Reads the next character applying the filter logic without advancing the current position in the stream.
Read()	int	Reads the next character applying the filter logic.