Metodo ITextTemplatingEngineHost.ResolveDirectiveProcessor

Articolo
08/11/2011

Restituisce il tipo di un processore di direttiva, dato il relativo nome descrittivo.

Spazio dei nomi: Microsoft.VisualStudio.TextTemplating
Assembly: Microsoft.VisualStudio.TextTemplating.Interfaces.10.0 (in Microsoft.VisualStudio.TextTemplating.Interfaces.10.0.dll)

Sintassi

'Dichiarazione
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

Parametri

processorName
Tipo: System.String
Nome del processore di direttiva da risolvere.

Valore restituito

Tipo: System.Type
Oggetto Type del processore di direttiva.

Note

Il motore chiama questo metodo in base alle direttive che l'utente ha specificato nel modello di testo. Questo metodo può essere chiamato 0, 1 o più volte per ogni trasformazione del modello di testo. Per ulteriori informazioni, vedere T4 Text Template Directives.

Se non è possibile risolvere il nome del processore di direttiva, questo metodo deve generare un'eccezione.

Se il meccanismo che l'host utilizza per trovare un processore di direttiva nel metodo ResolveDirectiveProcessor non è sicuro, potrebbe essere eseguito un processore di direttiva dannoso. Il processore di direttiva dannoso potrebbe fornire codice che viene eseguito in modalità di attendibilità totale quando viene eseguito il modello. Se si crea un host personalizzato, è necessario utilizzare un meccanismo sicuro, quale il Registro di sistema, per individuare i processori di direttiva. Per ulteriori informazioni, vedere Sicurezza dei modelli di testo.

Esempi

Nell'esempio di codice seguente viene illustrata una possibile implementazione di un host personalizzato. Questo esempio di codice fa parte di un esempio più esaustivo fornito per l'interfaccia ITextTemplatingEngineHost.

Per un esempio più dettagliato che mostra come risolvere una richiesta per un processore di direttive generato, vedere Procedura dettagliata: connessione di un host a un processore di direttiva generato.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.