BuildProvider.CodeCompilerType プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

BuildProvider.CodeCompilerType プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ビルドプロバイダで独自のファイルの種類でソースコードを生成するために使用されるコンパイラの種類を表します。

名前空間: System.Web.Compilation
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable ReadOnly
 Property CodeCompilerType As CompilerType

Visual Basic (使用法)

Dim instance As BuildProvider
Dim value As CompilerType

value = instance.CodeCompilerType

public virtual CompilerType CodeCompilerType { get;
 }

C++

public:
virtual property CompilerType^ CodeCompilerType {
    CompilerType^ get ();
}

/** @property */
public CompilerType get_CodeCompilerType ()

JScript

public function get CodeCompilerType
 () : CompilerType

プロパティ値
読み取り専用の System.Web.Compilation.CompilerType。仮想パスのソースコードをビルドするためのコードジェネレータ、コードコンパイラ、およびコンパイラ設定値を表します。基本クラスでは、null 参照 (Visual Basic では Nothing) が返されます。

解説

特定の BuildProvider 実装に対するソースコードのコンパイル設定値を指定するには、CodeCompilerType プロパティを使用します。ビルドプロバイダがソースコードの生成とコンパイルに独自のコード言語を必要としない場合、CodeCompilerType プロパティは null 参照 (Visual Basic では Nothing) です。

ビルドプロバイダの実装内で CompilerType オブジェクトの値を設定するには、GetDefaultCompilerType または GetDefaultCompilerTypeForLanguage メソッドを使用します。

CodeDomProviderType プロパティは、特定のビルドプロバイダに対するソースコードの生成とコンパイルに使用される CodeDomProvider の実装を指定します。CompilerParameters プロパティは、ソースコードをアセンブリにコンパイルするために使用する設定値を定義します。

使用例

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

Visual Basic

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 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.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

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()
    {
        _compilerType = GetDefaultCompilerTypeForLanguage("C#");
    }

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


    // 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.GenerateCodeFromCompileUnit(compileUnit, tw, null);
            }
            finally
            {
                tw.Close();
            }
        }
    }

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

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