RequiresProvidesDirectiveProcessor.ProcessDirective - метод

Статья
08/11/2011

Обрабатывает одну директиву из файла текстового шаблона.

Пространство имен: Microsoft.VisualStudio.TextTemplating
Сборка: Microsoft.VisualStudio.TextTemplating.10.0 (в Microsoft.VisualStudio.TextTemplating.10.0.dll)

Синтаксис

'Декларация
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>
)

Параметры

directiveName
Тип: System.String
Имя обрабатываемой директивы.

arguments
Тип: System.Collections.Generic.IDictionary<String, String>
Аргументы, необходимые директиве.

Исключения

Исключение	Условие
ArgumentNullException	Параметр directiveName имеет значение nullпустая ссылка (Nothing в Visual Basic). – или – Параметр arguments имеет значение nullпустая ссылка (Nothing в Visual Basic).
InvalidOperationException	Запуск обработки уже начат, но еще не завершен.
DirectiveProcessorException	Директива не поддерживается процессором. – или – Не удается определить параметр requires.

ArgumentNullException

Параметр directiveName имеет значение nullпустая ссылка (Nothing в Visual Basic).

– или –

Параметр arguments имеет значение nullпустая ссылка (Nothing в Visual Basic).

InvalidOperationException

Запуск обработки уже начат, но еще не завершен.

DirectiveProcessorException

Директива не поддерживается процессором.

– или –

Не удается определить параметр requires.

Заметки

Один процессор директивы может поддерживать множество директив. При вызове ProcessDirective условные операторы выполняются, с использованием вызываемой директивы.

Этот метод вызывается для каждого вызова в текстовом шаблоне для директивы, которую поддерживает этот процессор. Директива обрабатывает аргументы и создает код, который должен быть добавлен в созданный класс преобразования.

Этот метод переопределяется в RequiresProvidesDirectiveProcessor для вызова различных виртуальных методов в RequiresProvidesDirectiveProcessor. Например, GenerateTransformCode, GeneratePostInitializationCode и InitializeProvidesDictionary.

Обычно не требуется переопределять этот метод в классах, производных от RequiresProvidesDirectiveProcessor.

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.