RequiresProvidesDirectiveProcessor.ProcessDirective Method
Processes a single directive from a text template file.
Namespace: Microsoft.VisualStudio.TextTemplating
Assembly: Microsoft.VisualStudio.TextTemplating.12.0 (in Microsoft.VisualStudio.TextTemplating.12.0.dll)
Syntax
'Declaration
Public Overrides Sub ProcessDirective ( _
directiveName As String, _
arguments As IDictionary(Of String, String) _
)
public override void ProcessDirective(
string directiveName,
IDictionary<string, string> arguments
)
public:
virtual void ProcessDirective(
String^ directiveName,
IDictionary<String^, String^>^ arguments
) override
abstract ProcessDirective :
directiveName:string *
arguments:IDictionary<string, string> -> unit
override ProcessDirective :
directiveName:string *
arguments:IDictionary<string, string> -> unit
public override function ProcessDirective(
directiveName : String,
arguments : IDictionary<String, String>
)
Parameters
directiveName
Type: System.StringThe name of the directive to process.
arguments
Type: System.Collections.Generic.IDictionary<String, String>The arguments that the directive requires.
Implements
IDirectiveProcessor.ProcessDirective(String, IDictionaryString, String)
Exceptions
Exception | Condition |
---|---|
ArgumentNullException | directiveName is nulla null reference (Nothing in Visual Basic). -or- arguments is nulla null reference (Nothing in Visual Basic). |
InvalidOperationException | A processing run has already started but not yet finished. |
DirectiveProcessorException | The processor does not support the directive. -or- A requires parameter cannot be resolved. |
Remarks
One directive processor can support many directives. When ProcessDirective is called, conditional statements run using the directive that is called.
This method is called once for each call in a text template to a directive that this processor supports. The directives process the arguments and generate code to be added to the generated transformation class.
This method is overridden in RequiresProvidesDirectiveProcessor to call various virtual methods in RequiresProvidesDirectiveProcessor. For example, GenerateTransformCode, GeneratePostInitializationCode, and InitializeProvidesDictionary.
You do not usually need to override this method in classes that derive from RequiresProvidesDirectiveProcessor.
.NET Framework Security
- 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.
See Also
Reference
RequiresProvidesDirectiveProcessor Class
Microsoft.VisualStudio.TextTemplating Namespace