DirectiveProcessor.Initialize Method

When overridden in a derived class, initializes the processor instance.

Namespace:  Microsoft.VisualStudio.TextTemplating
Assembly:  Microsoft.VisualStudio.TextTemplating (in Microsoft.VisualStudio.TextTemplating.dll)

Syntax

'宣言
Public Overridable Sub Initialize ( _
    host As ITextTemplatingEngineHost _
)
'使用
Dim instance As DirectiveProcessor
Dim host As ITextTemplatingEngineHost

instance.Initialize(host)

public virtual void Initialize(
    ITextTemplatingEngineHost host
)

public:
virtual void Initialize(
    ITextTemplatingEngineHost^ host
)

public function Initialize(
    host : ITextTemplatingEngineHost
)

Parameters

• host
  Type: Microsoft.VisualStudio.TextTemplating.ITextTemplatingEngineHost

  The ITextTemplatingEngineHost of the DirectiveProcessor. The DirectiveProcessor can request information about the file system or the external environment from host.

Remarks

Initialize(ITextTemplatingEngineHost, CompilerErrorCollection) is called before StartProcessingRun(CodeDomProvider), and gives the directive processor the opportunity to get information it needs from the host.

You can throw an exception during Initialize(ITextTemplatingEngineHost, CompilerErrorCollection) to stop the processing.

Examples

The following code example shows a possible implementation for a custom directive processor. This code example is part of a larger example provided for the DirectiveProcessor class.

private int directiveCount;

public override void Initialize(ITextTemplatingEngineHost host)
{
    directiveCount = 0;
}

Private directiveCount As Integer

Public Overrides Sub Initialize(ByVal host As ITextTemplatingEngineHost)

    directiveCount = 0
End Sub

Permissions

• 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

Concepts

Directive Processors

Walkthrough: Creating a Custom Directive Processor

Reference

DirectiveProcessor Class

DirectiveProcessor Members

Microsoft.VisualStudio.TextTemplating Namespace

ITextTemplatingEngineHost

LogErrors

StartProcessingRun(CodeDomProvider)

Initialize(ITextTemplatingEngineHost, CompilerErrorCollection)