ITextTemplatingEngineHost.ResolveDirectiveProcessor – metoda

Článek
10/27/2012

Vrátí typ směrnice procesoru jeho 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 T4 Text šablony 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ého směrnice procesoru nelze spustit.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 zabezpečené mechanismus 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 poskytován ITextTemplatingEngineHost rozhraní.

Podrobnější příklad, který ukazuje, jak vyřešit požadavek generované směrnice procesoru, viz Názorný postup: Připojení hostitelského procesoru generované směrnice.

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.