Método ITextTemplatingEngineHost.ProvideTemplatingAppDomain

Artigo
08/01/2011

Fornece um domínio de aplicativo para executar a classe de transformação gerada.

Namespace: Microsoft.VisualStudio.TextTemplating
Assembly: Microsoft.VisualStudio.TextTemplating.Interfaces.10.0 (em Microsoft.VisualStudio.TextTemplating.Interfaces.10.0.dll)

Sintaxe

'Declaração
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

Parâmetros

content
Tipo: System.String
O conteúdo do arquivo de modelo de texto a ser processado.

Valor de retorno

Tipo: System.AppDomain
Um AppDomain que compila e executa a classe de transformação gerada.

Comentários

O host pode usar o content parâmetro para fornecer um específico AppDomain dependendo do arquivo de modelo de texto a ser processado. Por exemplo, o host pode armazenar em cache um AppDomain se o mesmo arquivo de modelo de texto está sendo processado repetidamente. O host pode ignorar o content parâmetro se o host não precisa de informações.

Exemplos

O exemplo de código a seguir mostra uma implementação possível para um host personalizado. Este exemplo de código é parte de um exemplo maior. For the complete example, see Demonstra Passo a passo: A criação de um Host de modelo de texto personalizado.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.