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

For a list of all members of this type, see CompilerResults Members.

System.Object
   System.CodeDom.Compiler.CompilerResults

[Visual Basic]
Public Class CompilerResults
[C#]
public class CompilerResults
[C++]
public __gc class CompilerResults
[JScript]
public class CompilerResults

Thread Safety

Any public static (Shared in Visual Basic) members of this type are safe for multithreaded operations. Any instance members are not guaranteed to be thread safe.

Remarks

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.

Example

[Visual Basic] 
' Displays information from a CompilerResults.
Public Shared Sub DisplayCompilerResults(ByVal cr As System.CodeDom.Compiler.CompilerResults)
    ' If errors occurred during compilation, output the compiler output and errors.
    If cr.Errors.Count > 0 Then
        Dim i As Integer
        For i = 0 To cr.Output.Count - 1
            Console.WriteLine(cr.Output(i))
        Next i        
        For i = 0 To cr.Errors.Count - 1
            Console.WriteLine((i.ToString() + ": " + cr.Errors(i).ToString()))
        Next i
    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 Is Nothing Then
            Console.WriteLine("The assembly has been generated in memory.")
        Else
            Console.WriteLine(("Path to assembly: " + cr.PathToAssembly))
        End If
        ' Display temporary files information.
        If Not cr.TempFiles.KeepFiles Then
            Console.WriteLine("Temporary build files were deleted.")
        Else
            Console.WriteLine("Temporary build files were not deleted.")
            ' Display a list of the temporary build files
            Dim enu As IEnumerator = cr.TempFiles.GetEnumerator()
            Dim i As Integer
            i = 0
            While enu.MoveNext()
                Console.WriteLine(("TempFile " + i.ToString() + ": " + CStr(enu.Current)))
                i += 1
            End While
        End If
    End If
End Sub

[C#] 
// 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 );                  
        }
    }
}

[C++] 
// 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->Item[i]);
      for (int i=0; i<cr->Errors->Count; i++)
         Console::WriteLine(String::Concat( __box(i), S": ", cr->Errors->Item[i]));

   } else {
      // Display information ab->Item[Out] the* compiler's exit code and the generated assembly.
      Console::WriteLine(S"Compiler returned with result code: {0}", 
         __box(cr->NativeCompilerReturnValue));
      Console::WriteLine(S"Generated assembly name: {0}",
         cr->CompiledAssembly->FullName);
      if (cr->PathToAssembly == 0)
         Console::WriteLine(S"The assembly has been generated in memory.");
      else
         Console::WriteLine(S"Path to assembly: {0}",
         cr->PathToAssembly);

      // Display temporary files information.
      if (!cr->TempFiles->KeepFiles)
         Console::WriteLine(S"Temporary build files were deleted.");
      else {
         Console::WriteLine(S"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(String::Concat(S"TempFile ", __box(i), S": ",
              dynamic_cast<String*>(enu->Current)));
      }
   }
}

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button in the upper-left corner of the page.

Requirements

Namespace: System.CodeDom.Compiler

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Assembly: System (in System.dll)

See Also

CompilerResults Members | System.CodeDom.Compiler Namespace | ICodeCompiler