IPreprocessorExtension Interface

Interface for extending the WiX toolset preprocessor.

Methods

Method	Description
EvaluateFunction(prefix, function, args)	Evaluates a function defined in the extension.
GetVariableValue(prefix, name)	Gets the value of a variable whose prefix matches the extension.
PostPreprocess()	Called at the end of the preprocessing of a source file.
PrePreprocess()	Called at the beginning of the preprocessing of a source file.
ProcessPragma(prefix, pragma, args, parent)	Processes a pragma defined in the extension.

Property	Description
Prefixes	Gets the variable prefixes for the extension.
`WixToolset.Extensibility.dll` version `5.0.0+41e11442b2ca93e444b60213b5ae99dcbab787d8`

Evaluates a function defined in the extension.

public string EvaluateFunction(
  string prefix,
  string function,
  System.String[] args
)

Parameter	Type	Description
prefix	string	The prefix of the function to be processed by the extension.
function	string	The name of the function.
args	System.String[]	The list of arguments.

string The value of the function or null if the function is not defined.

Gets the value of a variable whose prefix matches the extension.

public string GetVariableValue(
  string prefix,
  string name
)

Parameter	Type	Description
prefix	string	The prefix of the variable to be processed by the extension.
name	string	The name of the variable.

string The value of the variable or null if the variable is undefined.

Called at the end of the preprocessing of a source file.

public void PostPreprocess()

Called at the beginning of the preprocessing of a source file.

public void PrePreprocess()

Processes a pragma defined in the extension.

public bool ProcessPragma(
  string prefix,
  string pragma,
  string args,
  System.Xml.Linq.XContainer parent
)

Parameter	Type	Description
prefix	string	The prefix of the pragma to be processed by the extension.
pragma	string	The name of the pragma.
args	string	The pragma’s arguments.
parent	System.Xml.Linq.XContainer	The parent node of the pragma.

bool false if the pragma is not defined.

Gets the variable prefixes for the extension.

public System.String[] Prefixes { get; set; }