ITextTemplatingEngineHost.ResolveDirectiveProcessor – metoda

Článek
08/11/2011

Vrátí typ směrnice procesoru, popisný název.

Obor názvů: Microsoft.VisualStudio.TextTemplating
Sestavení: Microsoft.VisualStudio.TextTemplating.Interfaces.10.0 (v Microsoft.VisualStudio.TextTemplating.Interfaces.10.0.dll)

Syntaxe

'Deklarace
Function ResolveDirectiveProcessor ( _
    processorName As String _
) As Type

Type ResolveDirectiveProcessor(
    string processorName
)

Type^ ResolveDirectiveProcessor(
    String^ processorName
)

abstract ResolveDirectiveProcessor : 
        processorName:string -> Type

function ResolveDirectiveProcessor(
    processorName : String
) : Type

Parametry

processorName
Typ: System.String
Název směrnice procesoru přeložit.

Vrácená hodnota

Typ: System.Type
Type Směrnice procesoru.

Poznámky

Motor volání této metody na základě směrnic zadaný uživatel v šabloně text. Tuto metodu lze volat 0, 1 nebo více než jednou pro každou šablonu transformace textu. Další informace naleznete v tématu Text šablona směrnic.

Pokud nelze přeložit název směrnice procesoru, tato metoda vyvoláním výjimky.

Pokud mechanismus, který hostitel používá k nalezení směrnice procesoru v metodě ResolveDirectiveProcessor je bezpečný, škodlivý směrnice procesor může být spuštění. Kód, který je spuštěn v režimu úplný vztah důvěryhodnosti při spuštění šablony poskytnout škodlivého směrnice procesoru. Pokud vytvoříte vlastní hostitele, jako je například registr, musíte použít mechanismus zabezpečení vyhledejte směrnice procesorů. Další informace naleznete v tématu Text šablon zabezpečení.

Příklady

Následující příklad kódu ukazuje možné provedení vlastního hostitele. Příklad kódu je součástí větší příklad, který je stanoven ITextTemplatingEngineHost rozhraní.

Podrobnější příklad, který ukazuje, jak vyřešit požadavek generované směrnice procesoru, viz Walkthrough: Connecting a Host to a Generated Directive Processor.

public Type ResolveDirectiveProcessor(string processorName)
{
    //this host will not resolve any specific processors

    //check the processor name, and if it is the name of a processor the 
    //host wants to support, return the type of the processor
    //---------------------------------------------------------------------
    if (string.Compare(processorName, "XYZ", StringComparison.OrdinalIgnoreCase) == 0)
    {
        //return typeof();
    }

    //this can be customized to search specific paths for the file,
    //or to search the GAC

    //if the directive processor can not be found, throw an error
    throw new Exception("Directive Processor not found");
}

Public Function ResolveDirectiveProcessor(ByVal processorName As String) As System.Type Implements Microsoft.VisualStudio.TextTemplating.ITextTemplatingEngineHost.ResolveDirectiveProcessor
    'this host will not resolve any specific processors

    'check the processor name, and if it is the name of a processor the 
    'host wants to support, return the type of the processor
    '---------------------------------------------------------------------
    If String.Compare(processorName, "XYZ", StringComparison.OrdinalIgnoreCase) = 0 Then
        'return typeof()
    End If

    'this can be customized to search specific paths for the file,
    'or to search the GAC

    'if the directive processor can not be found, throw an error
    Throw New Exception("Directive Processor not found")
End Function

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.