CompilerParameters クラス
アセンブリ: System (system.dll 内)


CompilerParameters オブジェクトは、ICodeCompiler インターフェイスの設定とオプションを表します。
実行可能プログラムをコンパイルする場合は、GenerateExecutable プロパティを true に設定する必要があります。GenerateExecutable を false に設定すると、コンパイラはクラス ライブラリを生成します。既定では、新しい CompilerParameters は、その GenerateExecutable プロパティを false に設定して初期化されます。CodeDOM グラフから実行可能ファイルをコンパイルする場合は、CodeEntryPointMethod がグラフで定義されている必要があります。コードのエントリ ポイントが複数ある場合は、エントリ ポイントを定義したクラスのうち、使用するクラスの名前を MainClass プロパティに設定して示すことができます。
出力アセンブリのファイル名は、OutputAssembly プロパティに指定できます。この指定を行わない場合は、既定の出力ファイル名が使用されます。生成されるアセンブリにデバッグ情報を含めるには、IncludeDebugInformation プロパティを true に設定します。プロジェクトで参照しているアセンブリがある場合は、コンパイルを実行するときに使用される CompilerParameters の ReferencedAssemblies プロパティに設定される StringCollection の項目として、そのアセンブリ名を指定する必要があります。
GenerateInMemory プロパティを true に設定することで、ディスクではなくメモリに書き込まれるアセンブリをコンパイルできます。アセンブリをメモリ上に生成すると、コードでは、生成されたアセンブリへの参照を CompilerResults の CompiledAssembly プロパティから取得できます。アセンブリがディスクに書き込まれる場合は、生成されたアセンブリへのパスを CompilerResults の PathToAssembly プロパティから取得できます。
コンパイルを中断する警告レベルを指定するには、WarningLevel プロパティに、コンパイルを中断する警告レベルを表す整数を設定します。TreatWarningsAsErrors プロパティを true に設定して、警告が発生した場合にコンパイルを中断するようにコンパイラを構成することもできます。
コンパイル処理を実行するときに使用するカスタム コマンドライン引数の文字列を指定するには、CompilerOptions プロパティに文字列を設定します。コンパイラ プロセスを起動するために Win32 セキュリティ トークンが必要な場合は、そのトークンを UserToken プロパティに指定します。コンパイルされるアセンブリに .NET Framework リソース ファイルを含めるには、リソース ファイルの名前を EmbeddedResources プロパティに追加します。別のアセンブリ内の .NET Framework リソースを参照するには、リソース ファイルの名前を LinkedResources プロパティに追加します。コンパイルされるアセンブリに Win32 リソース ファイルを含めるには、Win32 リソース ファイルの名前を Win32Resource プロパティに指定します。
![]() |
---|
このクラスは、すべてのメンバに適用されるリンク確認要求および継承確認要求をクラス レベルで格納します。直前の呼び出し元または派生クラスに完全信頼のアクセス許可がない場合、SecurityException がスローされます。セキュリティ要求の詳細については、「リンク確認要求」および「継承確認要求」を参照してください。 |

CompilerParametersを使用して、コンパイラの各種設定とオプションを指定する例を次に示します。
Public Shared Function CompileCode(provider As CodeDomProvider, _ sourceFile As String, exeFile As String) As Boolean Dim cp As New CompilerParameters() ' Generate an executable instead of ' a class library. cp.GenerateExecutable = True ' Set the assembly file name to generate. cp.OutputAssembly = exeFile ' Generate debug information. cp.IncludeDebugInformation = True ' Add an assembly reference. cp.ReferencedAssemblies.Add("System.dll") ' Save the assembly as a physical file. cp.GenerateInMemory = False ' Set the level at which the compiler ' should start displaying warnings. cp.WarningLevel = 3 ' Set whether to treat all warnings as errors. cp.TreatWarningsAsErrors = False ' Set compiler argument to optimize output. cp.CompilerOptions = "/optimize" ' Set a temporary files collection. ' The TempFileCollection stores the temporary files ' generated during a build in the current directory, ' and does not delete them after compilation. cp.TempFiles = New TempFileCollection(".", True) If provider.Supports(GeneratorSupport.EntryPointMethod) Then ' Specify the class that contains ' the main method of the executable. cp.MainClass = "Samples.Class1" End If If provider.Supports(GeneratorSupport.Resources) Then ' Set the embedded resource file of the assembly. ' This is useful for culture-neutral resources, ' or default (fallback) resources. cp.EmbeddedResources.Add("Default.resources") ' Set the linked resource reference files of the assembly. ' These resources are included in separate assembly files, ' typically localized for a specific language and culture. cp.LinkedResources.Add("nb-no.resources") End If ' Invoke compilation. Dim cr As CompilerResults = _ provider.CompileAssemblyFromFile(cp, sourceFile) If cr.Errors.Count > 0 Then ' Display compilation errors. Console.WriteLine("Errors building {0} into {1}", _ sourceFile, cr.PathToAssembly) Dim ce As CompilerError For Each ce In cr.Errors Console.WriteLine(" {0}", ce.ToString()) Console.WriteLine() Next ce Else Console.WriteLine("Source {0} built into {1} successfully.", _ sourceFile, cr.PathToAssembly) Console.WriteLine("{0} temporary files created during the compilation.", _ cp.TempFiles.Count.ToString()) End If ' Return the results of compilation. If cr.Errors.Count > 0 Then Return False Else Return True End If End Function 'CompileCode
public static bool CompileCode(CodeDomProvider provider, String sourceFile, String exeFile) { CompilerParameters cp = new CompilerParameters(); // Generate an executable instead of // a class library. cp.GenerateExecutable = true; // Set the assembly file name to generate. cp.OutputAssembly = exeFile; // Generate debug information. cp.IncludeDebugInformation = true; // Add an assembly reference. cp.ReferencedAssemblies.Add( "System.dll" ); // Save the assembly as a physical file. cp.GenerateInMemory = false; // Set the level at which the compiler // should start displaying warnings. cp.WarningLevel = 3; // Set whether to treat all warnings as errors. cp.TreatWarningsAsErrors = false; // Set compiler argument to optimize output. cp.CompilerOptions = "/optimize"; // Set a temporary files collection. // The TempFileCollection stores the temporary files // generated during a build in the current directory, // and does not delete them after compilation. cp.TempFiles = new TempFileCollection(".", true); if (provider.Supports(GeneratorSupport.EntryPointMethod)) { // Specify the class that contains // the main method of the executable. cp.MainClass = "Samples.Class1"; } if (provider.Supports(GeneratorSupport.Resources)) { // Set the embedded resource file of the assembly. // This is useful for culture-neutral resources, // or default (fallback) resources. cp.EmbeddedResources.Add("Default.resources"); // Set the linked resource reference files of the assembly. // These resources are included in separate assembly files, // typically localized for a specific language and culture. cp.LinkedResources.Add("nb-no.resources"); } // Invoke compilation. CompilerResults cr = provider.CompileAssemblyFromFile(cp, sourceFile); if(cr.Errors.Count > 0) { // Display compilation errors. Console.WriteLine("Errors building {0} into {1}", sourceFile, cr.PathToAssembly); foreach(CompilerError ce in cr.Errors) { Console.WriteLine(" {0}", ce.ToString()); Console.WriteLine(); } } else { Console.WriteLine("Source {0} built into {1} successfully.", sourceFile, cr.PathToAssembly); Console.WriteLine("{0} temporary files created during the compilation." , cp.TempFiles.Count.ToString()); } // Return the results of compilation. if (cr.Errors.Count > 0) { return false; } else { return true; } }
static bool CompileCode( CodeDomProvider^ provider , String^ sourceFile, String^ exeFile ) { CompilerParameters^ cp = gcnew CompilerParameters; if ( !cp) { return false; } // Generate an executable instead of // a class library. cp->GenerateExecutable = true; // Set the assembly file name to generate. cp->OutputAssembly = exeFile; // Generate debug information. cp->IncludeDebugInformation = true; // Add an assembly reference. cp->ReferencedAssemblies->Add( "System.dll" ); // Save the assembly as a physical file. cp->GenerateInMemory = false; // Set the level at which the compiler // should start displaying warnings. cp->WarningLevel = 3; // Set whether to treat all warnings as errors. cp->TreatWarningsAsErrors = false; // Set compiler argument to optimize output. cp->CompilerOptions = "/optimize"; // Set a temporary files collection. // The TempFileCollection stores the temporary files // generated during a build in the current directory, // and does not delete them after compilation. cp->TempFiles = gcnew TempFileCollection( ".",true ); if ( provider->Supports( GeneratorSupport::EntryPointMethod ) ) { // Specify the class that contains // the main method of the executable. cp->MainClass = "Samples.Class1"; } if ( provider->Supports( GeneratorSupport::Resources ) ) { // Set the embedded resource file of the assembly. // This is useful for culture-neutral resources, // or default (fallback) resources. cp->EmbeddedResources->Add( "Default.resources" ); // Set the linked resource reference files of the assembly. // These resources are included in separate assembly files, // typically localized for a specific language and culture. cp->LinkedResources->Add( "nb-no.resources" ); } // Invoke compilation. CompilerResults^ cr = provider->CompileAssemblyFromFile( cp, sourceFile ); if ( cr->Errors->Count > 0 ) { // Display compilation errors. Console::WriteLine( "Errors building {0} into {1}", sourceFile, cr->PathToAssembly ); for each ( CompilerError^ ce in cr->Errors ) { Console::WriteLine( " {0}", ce->ToString() ); Console::WriteLine(); } } else { Console::WriteLine( "Source {0} built into {1} successfully.", sourceFile, cr->PathToAssembly ); } // Return the results of compilation. if ( cr->Errors->Count > 0 ) { return false; } else { return true; } }


System.CodeDom.Compiler.CompilerParameters


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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


CompilerParameters コンストラクタ ()
アセンブリ: System (system.dll 内)


CompilerParametersを使用して、コンパイラの各種設定とオプションを指定する例を次に示します。
Public Shared Function CompileCode(provider As CodeDomProvider, _ sourceFile As String, exeFile As String) As Boolean Dim cp As New CompilerParameters() ' Generate an executable instead of ' a class library. cp.GenerateExecutable = True ' Set the assembly file name to generate. cp.OutputAssembly = exeFile ' Generate debug information. cp.IncludeDebugInformation = True ' Add an assembly reference. cp.ReferencedAssemblies.Add("System.dll") ' Save the assembly as a physical file. cp.GenerateInMemory = False ' Set the level at which the compiler ' should start displaying warnings. cp.WarningLevel = 3 ' Set whether to treat all warnings as errors. cp.TreatWarningsAsErrors = False ' Set compiler argument to optimize output. cp.CompilerOptions = "/optimize" ' Set a temporary files collection. ' The TempFileCollection stores the temporary files ' generated during a build in the current directory, ' and does not delete them after compilation. cp.TempFiles = New TempFileCollection(".", True) If provider.Supports(GeneratorSupport.EntryPointMethod) Then ' Specify the class that contains ' the main method of the executable. cp.MainClass = "Samples.Class1" End If ' Invoke compilation. Dim cr As CompilerResults = _ provider.CompileAssemblyFromFile(cp, sourceFile) If cr.Errors.Count > 0 Then ' Display compilation errors. Console.WriteLine("Errors building {0} into {1}", _ sourceFile, cr.PathToAssembly) Dim ce As System.CodeDom.Compiler.CompilerError For Each ce In cr.Errors Console.WriteLine(" {0}", ce.ToString()) Console.WriteLine() Next ce Else Console.WriteLine("Source {0} built into {1} successfully.", _ sourceFile, cr.PathToAssembly) Console.WriteLine("{0} temporary files created during the compilation.", _ cp.TempFiles.Count.ToString()) End If ' Return the results of compilation. If cr.Errors.Count > 0 Then Return False Else Return True End If End Function 'CompileCode
public static bool CompileCode(CodeDomProvider provider, String sourceFile, String exeFile) { CompilerParameters cp = new CompilerParameters(); // Generate an executable instead of // a class library. cp.GenerateExecutable = true; // Set the assembly file name to generate. cp.OutputAssembly = exeFile; // Generate debug information. cp.IncludeDebugInformation = true; // Add an assembly reference. cp.ReferencedAssemblies.Add( "System.dll" ); // Save the assembly as a physical file. cp.GenerateInMemory = false; // Set the level at which the compiler // should start displaying warnings. cp.WarningLevel = 3; // Set whether to treat all warnings as errors. cp.TreatWarningsAsErrors = false; // Set compiler argument to optimize output. cp.CompilerOptions = "/optimize"; // Set a temporary files collection. // The TempFileCollection stores the temporary files // generated during a build in the current directory, // and does not delete them after compilation. cp.TempFiles = new TempFileCollection(".", true); if (provider.Supports(GeneratorSupport.EntryPointMethod)) { // Specify the class that contains // the main method of the executable. cp.MainClass = "Samples.Class1"; } // Invoke compilation. CompilerResults cr = provider.CompileAssemblyFromFile(cp, sourceFile); if(cr.Errors.Count > 0) { // Display compilation errors. Console.WriteLine("Errors building {0} into {1}", sourceFile, cr.PathToAssembly); foreach(CompilerError ce in cr.Errors) { Console.WriteLine(" {0}", ce.ToString()); Console.WriteLine(); } } else { Console.WriteLine("Source {0} built into {1} successfully.", sourceFile, cr.PathToAssembly); Console.WriteLine("{0} temporary files created during the compilation." , cp.TempFiles.Count.ToString()); } // Return the results of compilation. if (cr.Errors.Count > 0) { return false; } else { return true; } }
static bool CompileCode( CodeDomProvider^ provider , String^ sourceFile, String^ exeFile ) { CompilerParameters^ cp = gcnew CompilerParameters; if ( ( !cp) || ( !compiler) ) { return false; } // Generate an executable instead of // a class library. cp->GenerateExecutable = true; // Set the assembly file name to generate. cp->OutputAssembly = exeFile; // Generate debug information. cp->IncludeDebugInformation = true; // Add an assembly reference. cp->ReferencedAssemblies->Add( "System.dll" ); // Save the assembly as a physical file. cp->GenerateInMemory = false; // Set the level at which the compiler // should start displaying warnings. cp->WarningLevel = 3; // Set whether to treat all warnings as errors. cp->TreatWarningsAsErrors = false; // Set compiler argument to optimize output. cp->CompilerOptions = "/optimize"; // Set a temporary files collection. // The TempFileCollection stores the temporary files // generated during a build in the current directory, // and does not delete them after compilation. cp->TempFiles = gcnew TempFileCollection( ".",true ); if ( provider->Supports( GeneratorSupport::EntryPointMethod ) ) { // Specify the class that contains // the main method of the executable. cp->MainClass = "Samples.Class1"; } // Invoke compilation. CompilerResults^ cr = provider->CompileAssemblyFromFile( cp, sourceFile ); if ( cr->Errors->Count > 0 ) { // Display compilation errors. Console::WriteLine( "Errors building {0} into {1}", sourceFile, cr->PathToAssembly ); for each ( CompilerError^ ce in cr->Errors ) { Console::WriteLine( " {0}", ce->ToString() ); Console::WriteLine(); } } else { Console::WriteLine( "Source {0} built into {1} successfully.", sourceFile, cr->PathToAssembly ); } // Return the results of compilation. if ( cr->Errors->Count > 0 ) { return false; } else { return true; } }

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


CompilerParameters コンストラクタ (String[], String)
アセンブリ: System (system.dll 内)

Dim assemblyNames As String() Dim outputName As String Dim instance As New CompilerParameters(assemblyNames, outputName)
- outputName
出力ファイル名。

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


CompilerParameters コンストラクタ (String[])
アセンブリ: System (system.dll 内)


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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


CompilerParameters コンストラクタ (String[], String, Boolean)
アセンブリ: System (system.dll 内)

Public Sub New ( _ assemblyNames As String(), _ outputName As String, _ includeDebugInformation As Boolean _ )
Dim assemblyNames As String() Dim outputName As String Dim includeDebugInformation As Boolean Dim instance As New CompilerParameters(assemblyNames, outputName, includeDebugInformation)
public CompilerParameters ( string[] assemblyNames, string outputName, bool includeDebugInformation )
public: CompilerParameters ( array<String^>^ assemblyNames, String^ outputName, bool includeDebugInformation )
public CompilerParameters ( String[] assemblyNames, String outputName, boolean includeDebugInformation )
public function CompilerParameters ( assemblyNames : String[], outputName : String, includeDebugInformation : boolean )
- outputName
出力ファイル名。

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


CompilerParameters コンストラクタ

名前 | 説明 |
---|---|
CompilerParameters () | CompilerParameters クラスの新しいインスタンスを初期化します。 |
CompilerParameters (String[]) | 指定したアセンブリ名を使用して、CompilerParameters クラスの新しいインスタンスを初期化します。 |
CompilerParameters (String[], String) | 指定したアセンブリ名と出力ファイル名を使用して、CompilerParameters クラスの新しいインスタンスを初期化します。 |
CompilerParameters (String[], String, Boolean) | 指定したアセンブリ名、出力名、デバッグ情報を含めるかどうかを示す値を使用して、CompilerParameters クラスの新しいインスタンスを初期化します。 |

CompilerParameters プロパティ

名前 | 説明 | |
---|---|---|
![]() | CompilerOptions | コンパイラを起動するときに使用する、省略可能な追加コマンド ライン引数文字列を取得または設定します。 |
![]() | EmbeddedResources | アセンブリ出力をコンパイルするときに含める .NET Framework リソース ファイルを取得します。 |
![]() | Evidence | コンパイルしたアセンブリに与えるセキュリティ ポリシーのアクセス許可を表す証拠オブジェクトを指定します。 |
![]() | GenerateExecutable | 実行可能ファイルを生成するかどうかを示す値を取得または設定します。 |
![]() | GenerateInMemory | メモリ内で出力を生成するかどうかを示す値を取得または設定します。 |
![]() | IncludeDebugInformation | コンパイルされた実行可能ファイルにデバッグ情報を含めるかどうかを示す値を取得または設定します。 |
![]() | LinkedResources | 現在のソースで参照されている .NET Framework リソース ファイルを取得します。 |
![]() | MainClass | main クラスの名前を取得または設定します。 |
![]() | OutputAssembly | 出力アセンブリの名前を取得または設定します。 |
![]() | ReferencedAssemblies | 現在のプロジェクトで参照されるアセンブリを取得します。 |
![]() | TempFiles | 一時ファイルを格納するコレクションを取得または設定します。 |
![]() | TreatWarningsAsErrors | 警告をエラーとして扱うかどうかを示す値を取得または設定します。 |
![]() | UserToken | コンパイラ プロセスを作成するときに使用するユーザー トークンを取得または設定します。 |
![]() | WarningLevel | コンパイラがコンパイルを中止する警告レベルを取得または設定します。 |
![]() | Win32Resource | コンパイルされるアセンブリにリンクする Win32 リソース ファイルの名前を取得または設定します。 |

CompilerParameters メソッド

名前 | 説明 | |
---|---|---|
![]() | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
![]() | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
![]() | ToString | 現在の Object を表す String を返します。 ( Object から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |

CompilerParameters メンバ
CompilerParameters データ型で公開されるメンバを以下の表に示します。


名前 | 説明 | |
---|---|---|
![]() | CompilerOptions | コンパイラを起動するときに使用する、省略可能な追加コマンド ライン引数文字列を取得または設定します。 |
![]() | EmbeddedResources | アセンブリ出力をコンパイルするときに含める .NET Framework リソース ファイルを取得します。 |
![]() | Evidence | コンパイルしたアセンブリに与えるセキュリティ ポリシーのアクセス許可を表す証拠オブジェクトを指定します。 |
![]() | GenerateExecutable | 実行可能ファイルを生成するかどうかを示す値を取得または設定します。 |
![]() | GenerateInMemory | メモリ内で出力を生成するかどうかを示す値を取得または設定します。 |
![]() | IncludeDebugInformation | コンパイルされた実行可能ファイルにデバッグ情報を含めるかどうかを示す値を取得または設定します。 |
![]() | LinkedResources | 現在のソースで参照されている .NET Framework リソース ファイルを取得します。 |
![]() | MainClass | main クラスの名前を取得または設定します。 |
![]() | OutputAssembly | 出力アセンブリの名前を取得または設定します。 |
![]() | ReferencedAssemblies | 現在のプロジェクトで参照されるアセンブリを取得します。 |
![]() | TempFiles | 一時ファイルを格納するコレクションを取得または設定します。 |
![]() | TreatWarningsAsErrors | 警告をエラーとして扱うかどうかを示す値を取得または設定します。 |
![]() | UserToken | コンパイラ プロセスを作成するときに使用するユーザー トークンを取得または設定します。 |
![]() | WarningLevel | コンパイラがコンパイルを中止する警告レベルを取得または設定します。 |
![]() | Win32Resource | コンパイルされるアセンブリにリンクする Win32 リソース ファイルの名前を取得または設定します。 |

名前 | 説明 | |
---|---|---|
![]() | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
![]() | GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
![]() | ToString | 現在の Object を表す String を返します。 (Object から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |

Weblioに収録されているすべての辞書からCompilerParametersを検索する場合は、下記のリンクをクリックしてください。

- CompilerParametersのページへのリンク