ProjectCollection Constructors

Definition

Creates a project collection with no global properties or loggers. The project collection toolset is initialized from the configuration file and registry.

Overloads

ProjectCollection()

Instantiates a project collection with no global properties or loggers that reads toolset information from the configuration file and registry.

ProjectCollection(ToolsetDefinitionLocations)

Instantiates a project collection using toolsets from the specified locations, and no global properties or loggers. May throw InvalidToolsetDefinitionException.

ProjectCollection(IDictionary<String,String>)

Instantiates a project collection with specified global properties, no loggers, and that reads toolset information from the configuration file and registry. May throw InvalidToolsetDefinitionException.

ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, ToolsetDefinitionLocations)

Instantiates a project collection with specified global properties and loggers and using the specified toolset locations. May throw InvalidToolsetDefinitionException.

ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>, ToolsetDefinitionLocations, Int32, Boolean)

Instantiates a project collection with specified global properties and loggers and using the specified toolset locations, node count, and setting of onlyLogCriticalEvents. Global properties and loggers may be null. Throws InvalidProjectFileException if any of the global properties are reserved. May throw InvalidToolsetDefinitionException.

ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>, ToolsetDefinitionLocations, Int32, Boolean, Boolean)

Instantiates a project collection with specified global properties and loggers and using the specified toolset locations, node count, and setting of onlyLogCriticalEvents. Global properties and loggers may be null. Throws InvalidProjectFileException if any of the global properties are reserved. May throw InvalidToolsetDefinitionException.

ProjectCollection()

Instantiates a project collection with no global properties or loggers that reads toolset information from the configuration file and registry.

public:
 ProjectCollection();
public ProjectCollection ();
Public Sub New ()

Applies to

ProjectCollection(ToolsetDefinitionLocations)

Instantiates a project collection using toolsets from the specified locations, and no global properties or loggers. May throw InvalidToolsetDefinitionException.

public:
 ProjectCollection(Microsoft::Build::Evaluation::ToolsetDefinitionLocations toolsetLocations);
public ProjectCollection (Microsoft.Build.Evaluation.ToolsetDefinitionLocations toolsetLocations);
new Microsoft.Build.Evaluation.ProjectCollection : Microsoft.Build.Evaluation.ToolsetDefinitionLocations -> Microsoft.Build.Evaluation.ProjectCollection
Public Sub New (toolsetLocations As ToolsetDefinitionLocations)

Parameters

toolsetLocations
ToolsetDefinitionLocations

The locations from which to load toolsets.

Applies to

ProjectCollection(IDictionary<String,String>)

Instantiates a project collection with specified global properties, no loggers, and that reads toolset information from the configuration file and registry. May throw InvalidToolsetDefinitionException.

public:
 ProjectCollection(System::Collections::Generic::IDictionary<System::String ^, System::String ^> ^ globalProperties);
public ProjectCollection (System.Collections.Generic.IDictionary<string,string> globalProperties);
new Microsoft.Build.Evaluation.ProjectCollection : System.Collections.Generic.IDictionary<string, string> -> Microsoft.Build.Evaluation.ProjectCollection
Public Sub New (globalProperties As IDictionary(Of String, String))

Parameters

globalProperties
IDictionary<String,String>

The default global properties to use. May be null.

Remarks

May throw InvalidToolsetDefinitionException.

Applies to

ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, ToolsetDefinitionLocations)

Instantiates a project collection with specified global properties and loggers and using the specified toolset locations. May throw InvalidToolsetDefinitionException.

public:
 ProjectCollection(System::Collections::Generic::IDictionary<System::String ^, System::String ^> ^ globalProperties, System::Collections::Generic::IEnumerable<Microsoft::Build::Framework::ILogger ^> ^ loggers, Microsoft::Build::Evaluation::ToolsetDefinitionLocations toolsetDefinitionLocations);
public ProjectCollection (System.Collections.Generic.IDictionary<string,string> globalProperties, System.Collections.Generic.IEnumerable<Microsoft.Build.Framework.ILogger> loggers, Microsoft.Build.Evaluation.ToolsetDefinitionLocations toolsetDefinitionLocations);
new Microsoft.Build.Evaluation.ProjectCollection : System.Collections.Generic.IDictionary<string, string> * seq<Microsoft.Build.Framework.ILogger> * Microsoft.Build.Evaluation.ToolsetDefinitionLocations -> Microsoft.Build.Evaluation.ProjectCollection
Public Sub New (globalProperties As IDictionary(Of String, String), loggers As IEnumerable(Of ILogger), toolsetDefinitionLocations As ToolsetDefinitionLocations)

Parameters

globalProperties
IDictionary<String,String>

The default global properties to use. May be null.

loggers
IEnumerable<ILogger>

The loggers to register. May be null.

toolsetDefinitionLocations
ToolsetDefinitionLocations

The locations from which to load toolsets.

Remarks

May throw InvalidToolsetDefinitionException.

Applies to

ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>, ToolsetDefinitionLocations, Int32, Boolean)

Instantiates a project collection with specified global properties and loggers and using the specified toolset locations, node count, and setting of onlyLogCriticalEvents. Global properties and loggers may be null. Throws InvalidProjectFileException if any of the global properties are reserved. May throw InvalidToolsetDefinitionException.

public:
 ProjectCollection(System::Collections::Generic::IDictionary<System::String ^, System::String ^> ^ globalProperties, System::Collections::Generic::IEnumerable<Microsoft::Build::Framework::ILogger ^> ^ loggers, System::Collections::Generic::IEnumerable<Microsoft::Build::Logging::ForwardingLoggerRecord ^> ^ remoteLoggers, Microsoft::Build::Evaluation::ToolsetDefinitionLocations toolsetDefinitionLocations, int maxNodeCount, bool onlyLogCriticalEvents);
public ProjectCollection (System.Collections.Generic.IDictionary<string,string> globalProperties, System.Collections.Generic.IEnumerable<Microsoft.Build.Framework.ILogger> loggers, System.Collections.Generic.IEnumerable<Microsoft.Build.Logging.ForwardingLoggerRecord> remoteLoggers, Microsoft.Build.Evaluation.ToolsetDefinitionLocations toolsetDefinitionLocations, int maxNodeCount, bool onlyLogCriticalEvents);
new Microsoft.Build.Evaluation.ProjectCollection : System.Collections.Generic.IDictionary<string, string> * seq<Microsoft.Build.Framework.ILogger> * seq<Microsoft.Build.Logging.ForwardingLoggerRecord> * Microsoft.Build.Evaluation.ToolsetDefinitionLocations * int * bool -> Microsoft.Build.Evaluation.ProjectCollection
Public Sub New (globalProperties As IDictionary(Of String, String), loggers As IEnumerable(Of ILogger), remoteLoggers As IEnumerable(Of ForwardingLoggerRecord), toolsetDefinitionLocations As ToolsetDefinitionLocations, maxNodeCount As Integer, onlyLogCriticalEvents As Boolean)

Parameters

globalProperties
IDictionary<String,String>

The default global properties to use. May be null.

loggers
IEnumerable<ILogger>

The loggers to register. May be null and specified to any build instead.

remoteLoggers
IEnumerable<ForwardingLoggerRecord>

Any remote loggers to register. May be null and specified to any build instead.

toolsetDefinitionLocations
ToolsetDefinitionLocations

The locations from which to load toolsets.

maxNodeCount
Int32

The maximum number of nodes to use for building.

onlyLogCriticalEvents
Boolean

If set to true, only critical events will be logged.

Remarks

Throws InvalidProjectFileException if any of the global properties are reserved.

Applies to

ProjectCollection(IDictionary<String,String>, IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>, ToolsetDefinitionLocations, Int32, Boolean, Boolean)

Instantiates a project collection with specified global properties and loggers and using the specified toolset locations, node count, and setting of onlyLogCriticalEvents. Global properties and loggers may be null. Throws InvalidProjectFileException if any of the global properties are reserved. May throw InvalidToolsetDefinitionException.

public:
 ProjectCollection(System::Collections::Generic::IDictionary<System::String ^, System::String ^> ^ globalProperties, System::Collections::Generic::IEnumerable<Microsoft::Build::Framework::ILogger ^> ^ loggers, System::Collections::Generic::IEnumerable<Microsoft::Build::Logging::ForwardingLoggerRecord ^> ^ remoteLoggers, Microsoft::Build::Evaluation::ToolsetDefinitionLocations toolsetDefinitionLocations, int maxNodeCount, bool onlyLogCriticalEvents, bool loadProjectsReadOnly);
public ProjectCollection (System.Collections.Generic.IDictionary<string,string> globalProperties, System.Collections.Generic.IEnumerable<Microsoft.Build.Framework.ILogger> loggers, System.Collections.Generic.IEnumerable<Microsoft.Build.Logging.ForwardingLoggerRecord> remoteLoggers, Microsoft.Build.Evaluation.ToolsetDefinitionLocations toolsetDefinitionLocations, int maxNodeCount, bool onlyLogCriticalEvents, bool loadProjectsReadOnly);
new Microsoft.Build.Evaluation.ProjectCollection : System.Collections.Generic.IDictionary<string, string> * seq<Microsoft.Build.Framework.ILogger> * seq<Microsoft.Build.Logging.ForwardingLoggerRecord> * Microsoft.Build.Evaluation.ToolsetDefinitionLocations * int * bool * bool -> Microsoft.Build.Evaluation.ProjectCollection
Public Sub New (globalProperties As IDictionary(Of String, String), loggers As IEnumerable(Of ILogger), remoteLoggers As IEnumerable(Of ForwardingLoggerRecord), toolsetDefinitionLocations As ToolsetDefinitionLocations, maxNodeCount As Integer, onlyLogCriticalEvents As Boolean, loadProjectsReadOnly As Boolean)

Parameters

globalProperties
IDictionary<String,String>

The default global properties to use. May be null.

loggers
IEnumerable<ILogger>

The loggers to register. May be null and specified to any build instead.

remoteLoggers
IEnumerable<ForwardingLoggerRecord>

Any remote loggers to register. May be null and specified to any build instead.

toolsetDefinitionLocations
ToolsetDefinitionLocations

The locations from which to load toolsets.

maxNodeCount
Int32

The maximum number of nodes to use for building.

onlyLogCriticalEvents
Boolean

If set to true, only critical events will be logged.

loadProjectsReadOnly
Boolean

If set to true, load all projects as read-only.

Applies to