ITextTemplatingEngineHost.ProvideTemplatingAppDomain メソッド

2011-08-09

生成された変換クラスを実行するためのアプリケーションドメインを提供します。

名前空間: 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