ITextTemplatingEngineHost.ProvideTemplatingAppDomain - метод

Статья
08/11/2011

Предоставляет домен приложения для выполнения создаваемого класса преобразования.

Пространство имен: Microsoft.VisualStudio.TextTemplating
Сборка: Microsoft.VisualStudio.TextTemplating.Interfaces.10.0 (в Microsoft.VisualStudio.TextTemplating.Interfaces.10.0.dll)

Синтаксис

'Декларация
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

Параметры

content
Тип: System.String
Обрабатываемое содержимое текстового файла шаблона.

Возвращаемое значение

Тип: System.AppDomain
AppDomain , который компилирует и выполняет созданный класс преобразования.

Заметки

Основное приложение может использовать параметр content для предоставления конкретных AppDomain в зависимости от текстового файла шаблона для обработки. Например, узел может кэшировать AppDomain, если один и тот же файл шаблона текст обрабатывается несколько раз. Основное приложение может игнорировать параметр content, если ему не требуется эта информация.

Примеры

В следующем примере кода показана возможная реализация пользовательского основного приложения. Данный пример кода является частью большего примера. Полный пример см. в разделе Пошаговое руководство. Создание пользовательского хост-класса для текстовых шаблонов.

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

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.