Export (0) Print
Expand All

Engine Constructor

Initializes a new instance of the Engine class.

This member is overloaded. For complete information about this member, including syntax, usage, and examples, click a name in the overload list.

  Name Description
Public method Engine() Initializes a new instance of the Engine class.
Public method Engine(BuildPropertyGroup) Initializes a new instance of the Engine class.
Public method Engine(String) Obsolete. Initializes a new instance of the Engine class that has the specified BinPath.
Public method Engine(ToolsetDefinitionLocations) Initializes a new instance of the Engine class.
Public method Engine(BuildPropertyGroup, ToolsetDefinitionLocations) Initializes a new instance of the Engine class.
Public method Engine(BuildPropertyGroup, ToolsetDefinitionLocations, Int32, String) Initializes a new instance of the Engine class.
Top

The following example creates an Engine object and uses the BuildProjectFile method to build a project file. The FileLogger class is used to log information to a file.

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.Build.BuildEngine;

namespace BuildAProjectCS
{
    class Program
    {       
        static void Main(string[] args)
        {
            // Instantiate a new Engine object
            Engine engine = new Engine();

            // Point to the path that contains the .NET Framework 2.0 CLR and tools
            engine.BinPath = @"c:\windows\microsoft.net\framework\v2.0.xxxxx";


            // Instantiate a new FileLogger to generate build log
            FileLogger logger = new FileLogger();

            // Set the logfile parameter to indicate the log destination
            logger.Parameters = @"logfile=C:\temp\build.log";

            // Register the logger with the engine
            engine.RegisterLogger(logger);

            // Build a project file 
            bool success = engine.BuildProjectFile(@"c:\temp\validate.proj");

            //Unregister all loggers to close the log file
            engine.UnregisterAllLoggers();

            if (success)
                Console.WriteLine("Build succeeded.");
            else
                Console.WriteLine(@"Build failed. View C:\temp\build.log for details");

        }
    }
}
Show:
© 2015 Microsoft