Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

GeneratorSupport Enumeration

Defines identifiers used to determine whether a code generator supports certain types of code elements.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

Namespace: System.CodeDom.Compiler
Assembly: System (in system.dll)

[SerializableAttribute] 
[FlagsAttribute] 
public enum GeneratorSupport
/** @attribute SerializableAttribute() */ 
/** @attribute FlagsAttribute() */ 
public enum GeneratorSupport
SerializableAttribute 
FlagsAttribute 
public enum GeneratorSupport
 Member nameDescription
ArraysOfArraysIndicates the generator supports arrays of arrays. 
AssemblyAttributesIndicates the generator supports assembly attributes. 
ChainedConstructorArgumentsIndicates the generator supports chained constructor arguments. 
ComplexExpressionsIndicates the generator supports complex expressions. 
DeclareDelegatesIndicates the generator supports delegate declarations. 
DeclareEnumsIndicates the generator supports enumeration declarations. 
DeclareEventsIndicates the generator supports event declarations. 
DeclareIndexerPropertiesIndicates the generator supports the declaration of indexer properties. 
DeclareInterfacesIndicates the generator supports interface declarations. 
DeclareValueTypesIndicates the generator supports value type declarations. 
EntryPointMethodIndicates the generator supports a program entry point method designation. This is used when building executables. 
GenericTypeDeclarationIndicates the generator supports generic type declarations. 
GenericTypeReferenceIndicates the generator supports generic type references. 
GotoStatementsIndicates the generator supports goto statements. 
MultidimensionalArraysIndicates the generator supports referencing multidimensional arrays. Currently, the CodeDom cannot be used to instantiate multidimensional arrays. 
MultipleInterfaceMembersIndicates the generator supports the declaration of members that implement multiple interfaces. 
NestedTypesIndicates the generator supports the declaration of nested types. 
ParameterAttributesIndicates the generator supports parameter attributes. 
PartialTypesIndicates the generator supports partial type declarations. 
PublicStaticMembersIndicates the generator supports public static members. 
ReferenceParametersIndicates the generator supports reference and out parameters. 
ResourcesIndicates the generator supports compilation with .NET Framework resources. These can be default resources compiled directly into an assembly, or resources referenced in a satellite assembly. 
ReturnTypeAttributesIndicates the generator supports return type attribute declarations. 
StaticConstructorsIndicates the generator supports static constructors. 
TryCatchStatementsIndicates the generator supports try...catch statements. 
Win32ResourcesIndicates the generator supports compilation with Win32 resources. 

These identifiers are used when calling the Supports method of a code generator to determine whether the code generator supports generating certain types of code.

The following example illustrates using CompilerParameters to specify various compiler settings and options.

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

Windows 98, Windows Server 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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.