Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

ITextTemplatingEngineHost.ResolveParameterValue Method

Resolves the value of a parameter for a directive processor if the parameter is not specified in the template text.

Namespace:  Microsoft.VisualStudio.TextTemplating
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: 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: String

The name of the directive processor to which the directive belongs.

parameterName
Type: String

The name of the parameter to be resolved.

Return Value

Type: String
A String that represents the resolved parameter value.

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;
}

Show:
© 2015 Microsoft