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)

public enum class GeneratorSupport
/** @attribute SerializableAttribute() */ 
/** @attribute FlagsAttribute() */ 
public enum GeneratorSupport
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.

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( "Source {0} built into {1} successfully.",
         sourceFile, cr->PathToAssembly );

   // Return the results of compilation.
   if ( cr->Errors->Count > 0 )
      return false;
      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