DirectiveProcessor.StartProcessingRun Method

When overridden in a derived class, begins a round of directive processing.

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

Syntax

'宣言
Public Overridable Sub StartProcessingRun ( _
    languageProvider As CodeDomProvider, _
    templateContents As String, _
    errors As CompilerErrorCollection _
)
'使用
Dim instance As DirectiveProcessor
Dim languageProvider As CodeDomProvider
Dim templateContents As String
Dim errors As CompilerErrorCollection

instance.StartProcessingRun(languageProvider, _
    templateContents, errors)

public virtual void StartProcessingRun(
    CodeDomProvider languageProvider,
    string templateContents,
    CompilerErrorCollection errors
)

public:
virtual void StartProcessingRun(
    CodeDomProvider^ languageProvider, 
    String^ templateContents, 
    CompilerErrorCollection^ errors
)

public function StartProcessingRun(
    languageProvider : CodeDomProvider, 
    templateContents : String, 
    errors : CompilerErrorCollection
)

Parameters

• languageProvider
  Type: System.CodeDom.Compiler.CodeDomProvider

  The code generator used to create the generated transformation class.

• templateContents
  Type: System.String

  The contents of the text template that is being processed.

• errors
  Type: System.CodeDom.Compiler.CompilerErrorCollection

  A collection that the d[irective processor] can add errors and warnings to if necessary.

Remarks

The default language provider is CSharpCodeProvider.

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.

public override void StartProcessingRun(CodeDomProvider languageProvider, String templateContents, CompilerErrorCollection errors)
{
    //the engine has passed us the language of the text template
    //we will use that language to generate code later
    //----------------------------------------------------------
    this.codeDomProvider = languageProvider;
    this.templateContents = templateContents;
    this.errorsValue = errors;

    this.codeBuffer = new StringBuilder();
}

Public Overrides Sub StartProcessingRun(ByVal languageProvider As CodeDomProvider, ByVal templateContents As String, ByVal errors As CompilerErrorCollection)

    'the engine has passed us the language of the text template
    'we will use that language to generate code later
    '----------------------------------------------------------
    Me.codeDomProvider = languageProvider
    Me.templateContents = templateContents
    Me.errorsValue = errors

    Me.codeBuffer = New StringBuilder()
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

FinishProcessingRun

CodeDomProvider

VBCodeProvider

CSharpCodeProvider

StartProcessingRun(CodeDomProvider)