ITextTemplatingEngineHost.ResolveParameterValue Method
Resolves the value of a parameter for a directive processor if the parameter is not specified in the template text.
Assembly: Microsoft.VisualStudio.TextTemplating.Interfaces.10.0 (in Microsoft.VisualStudio.TextTemplating.Interfaces.10.0.dll)
string ResolveParameterValue( string directiveId, string processorName, string parameterName )
Parameters
- directiveId
- Type: System.String
The ID of the directive call to which the parameter belongs. This ID disambiguates repeated calls to the same directive from the same text template.
- processorName
- Type: System.String
The name of the directive processor to which the directive belongs.
- parameterName
- Type: System.String
The name of the parameter to be resolved.
This method can be called by a directive processor or from the code of a text template to get values from the text template host. Typically the directive processor will call the method to get a default value for a parameter of the directive.
For example, in the host that executes in the command-line utility TextTransform.exe, this method retrieves values from the –a command line option. For more information, see Generating Files with the TextTransform Utility.
The following code example shows a possible implementation for a custom host. This code example is part of a larger example. For the complete example, see Walkthrough: Creating a Custom Text Template Host.
public string ResolveParameterValue(string directiveId, string processorName, string parameterName) { if (directiveId == null) { throw new ArgumentNullException("the directiveId cannot be null"); } if (processorName == null) { throw new ArgumentNullException("the processorName cannot be null"); } if (parameterName == null) { throw new ArgumentNullException("the parameterName cannot be null"); } //code to provide "hard-coded" parameter values goes here //this code depends on the directive processors this host will interact with //if we cannot do better - return the empty string return String.Empty; }
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.
