CodeDomProvider.GenerateCodeFromCompileUnit メソッド

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

CodeDomProvider.GenerateCodeFromCompileUnit メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定した CodeDOM (Code Document Object Model) コンパイル単位のコードを生成し、指定したオプションを使用して、指定したテキスト ライタに生成されたコードを送信します。

名前空間: System.CodeDom.Compiler
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Overridable Sub GenerateCodeFromCompileUnit
 ( _
    compileUnit As CodeCompileUnit, _
    writer As TextWriter, _
    options As CodeGeneratorOptions _
)

Visual Basic (使用法)

Dim instance As CodeDomProvider
Dim compileUnit As CodeCompileUnit
Dim writer As TextWriter
Dim options As CodeGeneratorOptions

instance.GenerateCodeFromCompileUnit(compileUnit, writer, options)

C#

public virtual void GenerateCodeFromCompileUnit
 (
    CodeCompileUnit compileUnit,
    TextWriter writer,
    CodeGeneratorOptions options
)

C++

public:
virtual void GenerateCodeFromCompileUnit (
    CodeCompileUnit^ compileUnit, 
    TextWriter^ writer, 
    CodeGeneratorOptions^ options
)

J#

public void GenerateCodeFromCompileUnit (
    CodeCompileUnit compileUnit, 
    TextWriter writer, 
    CodeGeneratorOptions options
)

JScript

public function GenerateCodeFromCompileUnit
 (
    compileUnit : CodeCompileUnit, 
    writer : TextWriter, 
    options : CodeGeneratorOptions
)

パラメータ

compileUnit

コード生成の対象となる CodeCompileUnit。

writer

出力コードの送信先となる TextWriter。

options

コードを生成するために使用するオプションを示す CodeGeneratorOptions。

例外

例外の種類	条件
NotImplementedException	このメソッドと CreateGenerator メソッドは、いずれも派生クラスでオーバーライドされません。

解説

メモ
.NET Framework Version 1.0 および 1.1 では、このメソッドは、プロバイダの CreateGenerator メソッドによって返される ICodeGenerator 実装により提供されます。Version 2.0 では、このメソッドは、コード プロバイダによってオーバーライドされなくても、コード プロバイダで直接呼び出すことができます。コード プロバイダがこのメソッドをオーバーライドしない場合は、基本クラスによって ICodeGenerator 実装が呼び出されます。

継承時の注意 このメソッドをオーバーライドする場合、基本クラスの対応するメソッドを呼び出す必要はありません。基本クラスのメソッドは、コード ジェネレータを使用する既存のプロバイダとの互換性を維持するために、従来の CreateGenerator メソッドを派生クラスで使用することによりジェネレータを作成します。基本クラスのメソッドは、次に ICodeGenerator 実装の等価のメソッド呼び出して、この関数を実行します。コード ジェネレータを使用しないコード プロバイダから基本クラスのメソッドを呼び出した場合、NotImplementedException が発生します。

使用例

GenerateCodeFromCompileUnit メソッドを使用して、CodeCompileUnit から "Hello World" アプリケーションのコードを生成する方法を次のコード例に示します。このコード例は、CodeDomProvider クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

Public Shared Sub GenerateCode(ByVal
 provider As CodeDomProvider, ByVal compileunit
 As CodeCompileUnit)

    ' Build the source file name with the appropriate
    ' language extension.
    Dim sourceFile As String
    If provider.FileExtension.StartsWith(".")
 Then
        sourceFile = "TestGraph" + provider.FileExtension
    Else
        sourceFile = "TestGraph." + provider.FileExtension
    End If

    ' Create an IndentedTextWriter, constructed with
    ' a StreamWriter to the source file.
    Dim tw As New IndentedTextWriter(New
 StreamWriter(sourceFile, False), "    ")
    ' Generate source code using the code generator.
    provider.GenerateCodeFromCompileUnit(compileunit, tw, New
 CodeGeneratorOptions())
    ' Close the output file.
    tw.Close()
End Sub

C#

public static void GenerateCode(CodeDomProvider
 provider,
    CodeCompileUnit compileunit)
{
    // Build the source file name with the appropriate
    // language extension.
    String sourceFile;
    if (provider.FileExtension[0] == '.')
    {
        sourceFile = "TestGraph" + provider.FileExtension;
    }
    else
    {
        sourceFile = "TestGraph." + provider.FileExtension;
    }

    // Create an IndentedTextWriter, constructed with
    // a StreamWriter to the source file.
    IndentedTextWriter tw = new IndentedTextWriter(new
 StreamWriter(sourceFile, false), "    ");
    // Generate source code using the code generator.
    provider.GenerateCodeFromCompileUnit(compileunit, tw, new
 CodeGeneratorOptions());
    // Close the output file.
    tw.Close();
}

C++

static void GenerateCode( CodeDomProvider^
 provider, CodeCompileUnit^ compileunit )
{
    // Build the source file name with the appropriate
    // language extension.
    String^ sourceFile;
    if ( provider->FileExtension->StartsWith( "."
 ) )
    {
        sourceFile = String::Concat( "TestGraph", provider->FileExtension
 );
    }
    else
    {
        sourceFile = String::Concat( "TestGraph.", provider->FileExtension
 );
    }

    // Create an IndentedTextWriter, constructed with
    // a StreamWriter to the source file.
    IndentedTextWriter^ tw = gcnew IndentedTextWriter( gcnew StreamWriter( sourceFile,false
 ),"    " );

    // Generate source code using the code generator.
    provider->GenerateCodeFromCompileUnit( compileunit, tw, gcnew CodeGeneratorOptions
 );

    // Close the output file.
    tw->Close();
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
CodeDomProvider クラス
CodeDomProvider メンバ
System.CodeDom.Compiler 名前空間
TextWriter
CodeExpression クラス
CodeGeneratorOptions