Export (0) Print
Expand All

CompilerResults Class

Represents the results of compilation that are returned from a compiler.

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

[SerializableAttribute]
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public class CompilerResults

The CompilerResults type exposes the following members.

  NameDescription
Public methodCompilerResultsInitializes a new instance of the CompilerResults class that uses the specified temporary files.
Top

  NameDescription
Public propertyCompiledAssemblyGets or sets the compiled assembly.
Public propertyErrorsGets the collection of compiler errors and warnings.
Public propertyEvidence Obsolete. Indicates the evidence object that represents the security policy permissions of the compiled assembly.
Public propertyNativeCompilerReturnValueGets or sets the compiler's return value.
Public propertyOutputGets the compiler output messages.
Public propertyPathToAssemblyGets or sets the path of the compiled assembly.
Public propertyTempFilesGets or sets the temporary file collection to use.
Top

  NameDescription
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

This class contains the following information about the results of a compilation by an ICodeCompiler interface implementation:

  • The CompiledAssembly property indicates the compiled assembly.

  • The Evidence property indicates the security evidence for the assembly.

  • The PathToAssembly property indicates the path to the compiled assembly, if it was not generated only in memory.

  • The Errors property indicates any compiler errors and warnings.

  • The Output property contains the compiler output messages.

  • The NativeCompilerReturnValue property indicates result code value returned by the compiler.

  • The TempFiles property indicates the temporary files generated during compilation and linking.

NoteNote

This class contains an inheritance demand at the class level that applies to all members. A SecurityException is thrown when the derived class does not have full-trust permission. For details about inheritance demands, see Inheritance Demands.

// Displays information from a CompilerResults. 
public static void DisplayCompilerResults(System.CodeDom.Compiler.CompilerResults cr)
{
    // If errors occurred during compilation, output the compiler output and errors. 
    if( cr.Errors.Count > 0 )
    {
        for( int i=0; i<cr.Output.Count; i++ )                
            Console.WriteLine( cr.Output[i] );
        for( int i=0; i<cr.Errors.Count; i++ )                
            Console.WriteLine( i.ToString() + ": " + cr.Errors[i].ToString() );

    }
    else
    {
        // Display information about the compiler's exit code and the generated assembly.
        Console.WriteLine( "Compiler returned with result code: " + cr.NativeCompilerReturnValue.ToString() );
        Console.WriteLine( "Generated assembly name: " + cr.CompiledAssembly.FullName );
        if( cr.PathToAssembly == null )
            Console.WriteLine( "The assembly has been generated in memory." );
        else
            Console.WriteLine( "Path to assembly: " + cr.PathToAssembly );

        // Display temporary files information. 
        if( !cr.TempFiles.KeepFiles )                
            Console.WriteLine( "Temporary build files were deleted." );
        else
        {
            Console.WriteLine( "Temporary build files were not deleted." );
            // Display a list of the temporary build files
            IEnumerator enu = cr.TempFiles.GetEnumerator();                                        
            for( int i=0; enu.MoveNext(); i++ )                                          
                Console.WriteLine( "TempFile " + i.ToString() + ": " + (string)enu.Current );                  
        }
    }
}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft