AssemblyBuilder AssemblyBuilder AssemblyBuilder AssemblyBuilder Class

定義

ASP.NET プロジェクト内の 1 つ以上の仮想パスからアセンブリをビルドするためのコンテナーを提供します。Provides a container for building an assembly from one or more virtual paths within an ASP.NET project.

public ref class AssemblyBuilder
public class AssemblyBuilder
type AssemblyBuilder = class
Public Class AssemblyBuilder
継承
AssemblyBuilderAssemblyBuilderAssemblyBuilderAssemblyBuilder

次のコード例は、抽象から継承する単純なビルド プロバイダーの実装を示しています。BuildProvider基本クラス。The following code example illustrates a simple build provider implementation, inheriting from the abstract BuildProvider base class. ビルド プロバイダーは、 CodeCompilerTypeGetGeneratedType、およびGenerateCode基底クラスのメンバー。The build provider overrides the CodeCompilerType, GetGeneratedType, and GenerateCode members of the base class.

GenerateCodeメソッドの実装、ビルド プロバイダーは、アセンブリのコンパイルを使用するため、生成されたコードを追加、CreateCodeFileメソッド。In the GenerateCode method implementation, the build provider adds the generated code for the assembly compilation using the CreateCodeFile method. 例では、実装を含まない、SampleClassGeneratorクラス。The example does not include the implementation of the SampleClassGenerator class. 詳細については、「CodeCompileUnit」を参照してください。For more information, see 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 Microsoft.VisualBasic
Imports System
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

注釈

インスタンス、AssemblyBuilderクラスが併用BuildProviderクラス メソッドを 1 つまたは複数のファイルをコンパイル済みのアセンブリに組み込みます。Instances of the AssemblyBuilder class are used with BuildProvider class methods to build one or more files into a compiled assembly.

BuildProviderクラスは、個々 のファイルのビルド機能を定義し、AssemblyBuilderクラスはそれぞれに起因するソース コードを組み合わせてBuildProviderインスタンスを 1 つのアセンブリにします。The BuildProvider class defines build functionality for individual files, and the AssemblyBuilder class combines the source code contributed by each BuildProvider instance into a single assembly. ASP.NET ビルド環境、AssemblyBuilderオブジェクトをBuildProviderメソッドの 1 つまたは複数のファイルからアセンブリを作成するときにそのように各BuildProviderインスタンスは、ファイル全体のアセンブリをファイルのソース コードを投稿できます。The ASP.NET build environment passes an AssemblyBuilder object to the BuildProvider methods when building an assembly from one or more files, so that each BuildProvider instance can contribute source code for its file to the overall assembly.

ASP.NET ビルド環境を決定、言語とコンパイラを基に、プロジェクト内のファイルに必要なBuildProvider.CodeCompilerTypeプロパティ。The ASP.NET build environment determines the language and compiler required by files within the project, based on the BuildProvider.CodeCompilerType property. ビルド環境のグループのファイルは、コンパイラ設定に基づいており、同じコンパイラが必要なファイルからアセンブリをビルドします。The build environment groups files based on their compiler settings and builds an assembly from files that require the same compiler.

CodeDomProviderプロパティを示します、 CodeDomProvider ASP.NET ビルド環境を使用して、ソース コードからアセンブリをコンパイルする実装に起因各BuildProvider実装します。The CodeDomProvider property indicates the CodeDomProvider implementation that the ASP.NET build environment uses to compile an assembly from the source code contributed by each BuildProvider implementation.

ABuildProviderオブジェクトを使用して CodeDOM グラフの形式でソース コードの貢献、AddCodeCompileUnitメソッド。A BuildProvider object contributes source code in the form of a CodeDOM graph using the AddCodeCompileUnit method. ABuildProviderオブジェクトを使用して、物理ファイルに格納されているソース コードの貢献、CreateCodeFileメソッド。A BuildProvider object contributes source code stored in a physical file using the CreateCodeFile method.

それぞれの後BuildProviderオブジェクトは、適切なソース コードを貢献AssemblyBuilderメソッド、ASP.NET ビルド環境の使用、AssemblyBuilderアセンブリに収集されたソース コードをコンパイルするクラス。After each BuildProvider object contributes source code using the appropriate AssemblyBuilder methods, the ASP.NET build environment uses the AssemblyBuilder class to compile the collected source code into an assembly.

プロパティ

CodeDomProvider CodeDomProvider CodeDomProvider CodeDomProvider

ソース コードをアセンブリにビルドするためのコンパイラを取得します。Gets the compiler used to build source code into an assembly.

メソッド

AddAssemblyReference(Assembly) AddAssemblyReference(Assembly) AddAssemblyReference(Assembly) AddAssemblyReference(Assembly)

1 つのファイルについて生成されたソース コードが参照するアセンブリを追加します。Adds an assembly that is referenced by source code generated for a file.

AddCodeCompileUnit(BuildProvider, CodeCompileUnit) AddCodeCompileUnit(BuildProvider, CodeCompileUnit) AddCodeCompileUnit(BuildProvider, CodeCompileUnit) AddCodeCompileUnit(BuildProvider, CodeCompileUnit)

アセンブリのソース コードを CodeDOM グラフの形式で追加します。Adds source code for the assembly in the form of a CodeDOM graph.

CreateCodeFile(BuildProvider) CreateCodeFile(BuildProvider) CreateCodeFile(BuildProvider) CreateCodeFile(BuildProvider)

ビルド プロバイダーが一時的なソース ファイルを作成して、そのソース ファイルをアセンブリのコンパイルに含めることができるようにします。Allows a build provider to create a temporary source file, and include the source file in the assembly compilation.

CreateEmbeddedResource(BuildProvider, String) CreateEmbeddedResource(BuildProvider, String) CreateEmbeddedResource(BuildProvider, String) CreateEmbeddedResource(BuildProvider, String)

ビルド プロバイダーがリソース ファイルを作成して、そのファイルをアセンブリ コンパイルに含めることができるようにします。Allows a build provider to create a resource file to include in the assembly compilation.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GenerateTypeFactory(String) GenerateTypeFactory(String) GenerateTypeFactory(String) GenerateTypeFactory(String)

型に対する高速オブジェクトのファクトリ テンプレートを、コンパイル対象アセンブリに挿入します。Inserts a fast object factory template for a type into the compiled assembly.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetTempFilePhysicalPath(String) GetTempFilePhysicalPath(String) GetTempFilePhysicalPath(String) GetTempFilePhysicalPath(String)

一時ファイルのパスを生成します。Generates a temporary file path.

GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象

こちらもご覧ください