Metodo ITextTemplatingEngineHost.ProvideTemplatingAppDomain

Articolo
08/11/2011

Fornisce un dominio applicazione per eseguire la classe Transformation generata.

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

Sintassi

'Dichiarazione
Function ProvideTemplatingAppDomain ( _
    content As String _
) As AppDomain

AppDomain ProvideTemplatingAppDomain(
    string content
)

AppDomain^ ProvideTemplatingAppDomain(
    String^ content
)

abstract ProvideTemplatingAppDomain : 
        content:string -> AppDomain

function ProvideTemplatingAppDomain(
    content : String
) : AppDomain

Parametri

content
Tipo: System.String
Il contenuto del file modello di testo da elaborare.

Valore restituito

Tipo: System.AppDomain
Oggetto AppDomain che compila ed esegue la classe Transformation generata.

Note

L'host può utilizzare il parametro content per fornire un oggetto AppDomain specifico a seconda del file del modello di testo da elaborare. Ad esempio, l'host potrebbe memorizzare nella cache un oggetto AppDomain se lo stesso file del modello di testo viene elaborato ripetutamente. L'host può ignorare il parametro content se non ha bisogno dell'informazione.

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. Per l'esempio completo, vedere Walkthrough: Creating a Custom Text Template Host.

public AppDomain ProvideTemplatingAppDomain(string content)
{
    //this host will provide a new application domain each time the 
    //engine processes a text template
    //-------------------------------------------------------------
    return AppDomain.CreateDomain("Generation App Domain");

    //this could be changed to return the current appdomain, but new 
    //assemblies are loaded into this AppDomain on a regular basis
    //if the AppDomain lasts too long, it will grow indefintely 
    //which might be regarded as a leak

    //this could be customized to cache the application domain for 
    //a certain number of text template generations (for example 10)

    //this could be customized based on the contents of the text 
    //template, which are provided as a parameter for that purpose
}

Public Function ProvideTemplatingAppDomain(ByVal content As String) As System.AppDomain Implements Microsoft.VisualStudio.TextTemplating.ITextTemplatingEngineHost.ProvideTemplatingAppDomain

    'this host will provide a new application domain each time the 
    'engine processes a text template
    '-------------------------------------------------------------
    Return AppDomain.CreateDomain("Generation App Domain")

    'this could be changed to return the current application domain, but new 
    'assemblies are loaded into this application domain on a regular basis
    'if the application domain lasts too long, it will grow indefintely 
    'which might be regarded as a leak

    'this could be customized to cache the application domain for 
    'a certain number of text template generations (for example 10)

    'this could be customized based on the contents of the text 
    'template, which are provided as a parameter for that purpose
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.