GeneratorSupport 列挙体

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

GeneratorSupport 列挙体

コード ジェネレータが特定の型のコード要素をサポートしているかどうかを判断するために使用する識別子を定義します。

この列挙体には、メンバ値のビットごとの組み合わせを可能にする FlagsAttribute 属性が含まれています。

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

Visual Basic (宣言)

<SerializableAttribute> _
<FlagsAttribute> _
Public Enumeration GeneratorSupport

Visual Basic (使用法)

Dim instance As GeneratorSupport

C#

[SerializableAttribute] 
[FlagsAttribute] 
public enum GeneratorSupport

C++

[SerializableAttribute] 
[FlagsAttribute] 
public enum class GeneratorSupport

J#

/** @attribute SerializableAttribute() */ 
/** @attribute FlagsAttribute() */ 
public enum GeneratorSupport

JScript

SerializableAttribute 
FlagsAttribute 
public enum GeneratorSupport

メンバ

	メンバ名	説明
	ArraysOfArrays	コード ジェネレータが配列の配列をサポートしていることを示します。
	AssemblyAttributes	コード ジェネレータがアセンブリ属性をサポートしていることを示します。
	ChainedConstructorArguments	コード ジェネレータがチェイン コンストラクタ引数をサポートしていることを示します。
	ComplexExpressions	コード ジェネレータが複雑な式をサポートしていることを示します。
	DeclareDelegates	コード ジェネレータがデリゲートの宣言をサポートしていることを示します。
	DeclareEnums	コード ジェネレータが列挙体の宣言をサポートしていることを示します。
	DeclareEvents	コード ジェネレータがイベントの宣言をサポートしていることを示します。
	DeclareIndexerProperties	コード ジェネレータがインデクサ プロパティの宣言をサポートしていることを示します。
	DeclareInterfaces	コード ジェネレータがインターフェイスの宣言をサポートしていることを示します。
	DeclareValueTypes	コード ジェネレータが値型の宣言をサポートしていることを示します。
	EntryPointMethod	コード ジェネレータがプログラム エントリ ポイント メソッドの指定をサポートしていることを示します。この識別子は、実行可能ファイルを作成するときに使用されます。
	GenericTypeDeclaration	コード ジェネレータがジェネリック型の宣言をサポートしていることを示します。
	GenericTypeReference	コード ジェネレータがジェネリック型参照をサポートしていることを示します。
	GotoStatements	コード ジェネレータが goto ステートメントをサポートしていることを示します。
	MultidimensionalArrays	コード ジェネレータが多次元配列の参照をサポートしていることを示します。現在、CodeDom を使用して多次元配列をインスタンス化することはできません。
	MultipleInterfaceMembers	コード ジェネレータが複数のインターフェイスを実装するメンバの宣言をサポートしていることを示します。
	NestedTypes	コード ジェネレータが入れ子にされた型の宣言をサポートしていることを示します。
	ParameterAttributes	コード ジェネレータがパラメータ属性をサポートしていることを示します。
	PartialTypes	コード ジェネレータが部分型の宣言をサポートしていることを示します。
	PublicStaticMembers	コード ジェネレータがパブリック静的メンバをサポートしていることを示します。
	ReferenceParameters	ジェネレータが参照パラメータおよび out パラメータをサポートしていることを示します。
	Resources	コード ジェネレータが .NET Framework リソースのコンパイルをサポートしていることを示します。これらは、アセンブリに直接コンパイルされる既定のリソース、またはサテライト アセンブリで参照されるリソースです。
	ReturnTypeAttributes	コード ジェネレータが戻り値の型の属性宣言をサポートしていることを示します。
	StaticConstructors	コード ジェネレータが静的コンストラクタをサポートしていることを示します。
	TryCatchStatements	コード ジェネレータが try...catch ステートメントをサポートしていることを示します。
	Win32Resources	コード ジェネレータが Win32 リソースのコンパイルをサポートしていることを示します。

解説

これらの識別子は、コード ジェネレータで特定の型のコードを生成できるかどうかを判断するために、コード ジェネレータの Supports メソッドを呼び出すときに使用されます。

使用例

CompilerParametersを使用して、コンパイラの各種設定とオプションを指定する例を次に示します。

Visual Basic

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
   

C#

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;
    }
}

C++

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;
   }
}

プラットフォーム

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、1.1、1.0

参照

関連項目
System.CodeDom.Compiler 名前空間
ICodeGenerator
Supports
CompilerParameters クラス