AssemblyBuilder.CreateCodeFile(BuildProvider) メソッド

リファレンス

定義

名前空間:: System.Web.Compilation

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ビルドプロバイダーが一時的なソースファイルを作成して、そのソースファイルをアセンブリのコンパイルに含めることができるようにします。

public:
 System::IO::TextWriter ^ CreateCodeFile(System::Web::Compilation::BuildProvider ^ buildProvider);

public System.IO.TextWriter CreateCodeFile (System.Web.Compilation.BuildProvider buildProvider);

member this.CreateCodeFile : System.Web.Compilation.BuildProvider -> System.IO.TextWriter

Public Function CreateCodeFile (buildProvider As BuildProvider) As TextWriter

パラメーター

buildProvider: BuildProvider

コードソースファイルを生成ためのビルドプロバイダー。

戻り値

TextWriter

ソースコードを一時ファイルに書き込むために使用できる、開かれた TextWriter。

例

次のコード例は、抽象 BuildProvider 基本クラスから継承する単純なビルドプロバイダーの実装を示しています。ビルドプロバイダーは、基底クラスの CodeCompilerType、 GetGeneratedType、および GenerateCode メンバーをオーバーライドします。

メソッドの GenerateCode 実装では、ビルドプロバイダーは、メソッドを使用してアセンブリコンパイル用に生成されたコードを CreateCodeFile 追加します。この例には、クラスの実装は SampleClassGenerator 含まれていません。詳細については、「CodeCompileUnit」を参照してください。

using System;
using System.Collections;
using System.IO;
using System.Text;
using System.Web;
using System.Web.Compilation;
using System.CodeDom.Compiler;
using System.CodeDom;
using System.Security;
using System.Security.Permissions;

// Define a simple build provider implementation.
[PermissionSet(SecurityAction.Demand, Unrestricted = true)]
public class SampleBuildProvider : BuildProvider
{
    // Define an internal member for the compiler type.
    protected CompilerType _compilerType = null;

    public SampleBuildProvider()
    {
        // Set the compiler to use Visual Basic.
        _compilerType = GetDefaultCompilerTypeForLanguage("C#");
    }

    // Return the internal CompilerType member 
    // defined in this implementation.
    public override CompilerType CodeCompilerType
    {
        get { return _compilerType; }
    }

    // Define a method that returns details for the 
    // code compiler for this build provider.
    public string GetCompilerTypeDetails()
    {
        StringBuilder details = new StringBuilder("");

        if (_compilerType != null)
        {
            // Format a string that contains the code compiler
            // implementation, and various compiler details.

            details.AppendFormat("CodeDomProvider type: {0}; \n",
                _compilerType.CodeDomProviderType.ToString());
            details.AppendFormat("Compiler debug build = {0}; \n",
                _compilerType.CompilerParameters.IncludeDebugInformation.ToString());
            details.AppendFormat("Compiler warning level = {0}; \n",
                _compilerType.CompilerParameters.WarningLevel.ToString());

            if (_compilerType.CompilerParameters.CompilerOptions != null)
            {
                details.AppendFormat("Compiler options: {0}; \n",
                    _compilerType.CompilerParameters.CompilerOptions.ToString());
            }
        }
        return details.ToString();
    }

    // Define the build provider implementation of the GenerateCode method.
    public override void GenerateCode(AssemblyBuilder assemBuilder)
    {
        // Generate a code compile unit, and add it to
        // the assembly builder.

        TextWriter tw = assemBuilder.CreateCodeFile(this);
        if (tw != null)
        {
            try
            {
                // Generate the code compile unit from the virtual path.
                CodeCompileUnit compileUnit = SampleClassGenerator.BuildCompileUnitFromPath(VirtualPath);

                // Generate the source for the code compile unit, 
                // and write it to a file specified by the assembly builder.
                CodeDomProvider provider = assemBuilder.CodeDomProvider;
                provider.CreateGenerator().GenerateCodeFromCompileUnit(compileUnit, tw, null);
            }
            finally
            {
                tw.Close();
            }
        }
    }

    public override System.Type GetGeneratedType(CompilerResults results)
    {
        string typeName = SampleClassGenerator.TypeName;

        return results.CompiledAssembly.GetType(typeName);
    }
}

Imports System.Collections
Imports System.IO
Imports System.Text
Imports System.Web
Imports System.Web.Compilation
Imports System.CodeDom.Compiler
Imports System.CodeDom
Imports System.Security
Imports System.Security.Permissions

<PermissionSet(SecurityAction.Demand, Unrestricted := true)> _
Public Class SampleBuildProvider
    Inherits BuildProvider

    Protected _compilerType As CompilerType = Nothing

    Public Sub New()
        _compilerType = GetDefaultCompilerType()
    End Sub

    ' Return the internal CompilerType member 
    ' defined in this implementation.
    Public Overrides ReadOnly Property CodeCompilerType() As CompilerType
        Get
            CodeCompilerType = _compilerType
        End Get
    End Property

    ' Define a method that returns details for the 
    ' code compiler for this build provider.
    Public Function GetCompilerTypeDetails() As String
        Dim details As StringBuilder = New StringBuilder("")

        If Not _compilerType Is Nothing Then
            ' Format a string that contains the code compiler
            ' implementation, and various compiler details.

            details.AppendFormat("CodeDomProvider type: {0}; ", _
                _compilerType.CodeDomProviderType.ToString())
            details.AppendFormat("Compiler debug build = {0}; ", _
                _compilerType.CompilerParameters.IncludeDebugInformation.ToString())
            details.AppendFormat("Compiler warning level = {0}; ", _
                _compilerType.CompilerParameters.WarningLevel.ToString())

            If Not _compilerType.CompilerParameters.CompilerOptions Is Nothing Then
                details.AppendFormat("Compiler options: {0}; ", _
                    _compilerType.CompilerParameters.CompilerOptions.ToString())
            End If
        End If
        Return details.ToString()
    End Function

    ' Define the build provider implementation of the GenerateCode method.
    Public Overrides Sub GenerateCode(ByVal assemBuilder As AssemblyBuilder)
        ' Generate a code compile unit, and add it to
        ' the assembly builder.

        Dim tw As TextWriter = assemBuilder.CreateCodeFile(Me)
        If Not tw Is Nothing Then
            Try
                ' Generate the code compile unit from the virtual path.
                Dim compileUnit As CodeCompileUnit = _
                        SampleClassGenerator.BuildCompileUnitFromPath(VirtualPath)

                ' Generate the source for the code compile unit, 
                ' and write it to a file specified by the assembly builder.
                Dim provider As CodeDomProvider = assemBuilder.CodeDomProvider
                provider.CreateGenerator().GenerateCodeFromCompileUnit(compileUnit, tw, Nothing)
            Finally
                tw.Close()
            End Try

        End If
    End Sub

    Public Overrides Function GetGeneratedType(ByVal results As CompilerResults) As System.Type
        Dim typeName As String = SampleClassGenerator.TypeName

        Return results.CompiledAssembly.GetType(typeName)
    End Function

End Class

注釈

実装では BuildProvider 、仮想パスの CreateCodeFile ソースファイルを生成するときにメソッドを呼び出します。で CreateCodeFile 追加されたソースコードは、アセンブリのコンパイルに含まれています。

通常、ビルドプロバイダー GenerateCode メソッドの実装では、プロパティを VirtualPath 読み取り、内容を解析してから、生成されたソースコードを指定した AssemblyBuilder オブジェクトに追加します。ビルドプロバイダーは、メソッドを CreateCodeFile 使用して、ソースコードを物理ファイルとしてアセンブリに追加します。または、ビルドプロバイダーはメソッドを AddCodeCompileUnit 使用して、ソースコードを CodeDOM グラフとしてアセンブリに追加することもできます。

を呼び出 CreateCodeFileした後、ビルドプロバイダーは、返された TextWriter オブジェクトを使用してソースファイルの内容を書き込みます。ソースファイルを記述した後、オブジェクトはメソッドをBuildProvider Close使用してオブジェクトを閉じ、関連付けられているシステムリソースをTextWriter解放する必要があります。

適用対象

次の方法で共有

AssemblyBuilder.CreateCodeFile(BuildProvider) メソッド

定義

パラメーター

戻り値

例

注釈

適用対象

こちらもご覧ください

その他のリソース