ProjectInstance Constructors
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Creates a new project instance.
Overloads
| ProjectInstance(ProjectRootElement) |
Creates a ProjectInstance directly. No intermediate Project object is created. This is ideal if the project is simply going to be built, and not displayed or edited. Uses the default project collection. |
| ProjectInstance(String) |
Creates a ProjectInstance directly. No intermediate Project object is created. This is ideal if the project is simply going to be built, and not displayed or edited. Uses the default project collection. |
| ProjectInstance(Project, ProjectInstanceSettings) |
Creates a ProjectInstance from an external created Project. Properties and items are cloned immediately and only the instance data is stored. |
| ProjectInstance(String, IDictionary<String,String>, String) |
Creates a ProjectInstance directly. No intermediate Project object is created. This is ideal if the project is simply going to be built, and not displayed or edited. Uses the default project collection. |
| ProjectInstance(ProjectRootElement, IDictionary<String,String>, String, ProjectCollection) |
Creates a ProjectInstance directly. No intermediate Project object is created. This is ideal if the project is simply going to be built, and not displayed or edited. Global properties may be null. Tools version may be null. |
| ProjectInstance(String, IDictionary<String,String>, String, ProjectCollection) |
Creates a ProjectInstance directly. No intermediate Project object is created. This is ideal if the project is simply going to be built, and not displayed or edited. Global properties may be null. Tools version may be null. |
| ProjectInstance(ProjectRootElement, IDictionary<String,String>, String, String, ProjectCollection) |
Creates a ProjectInstance directly. No intermediate Project object is created. This is ideal if the project is simply going to be built, and not displayed or edited. Global properties may be null. Tools version may be null. Sub-toolset version may be null, but if specified will override all other methods of determining the sub-toolset. |
| ProjectInstance(String, IDictionary<String,String>, String, String, ProjectCollection) |
Creates a ProjectInstance directly. No intermediate Project object is created. This is ideal if the project is simply going to be built, and not displayed or edited. Global properties may be null. Tools version may be null. |
ProjectInstance(ProjectRootElement)
Creates a ProjectInstance directly. No intermediate Project object is created. This is ideal if the project is simply going to be built, and not displayed or edited. Uses the default project collection.
public:
ProjectInstance(Microsoft::Build::Construction::ProjectRootElement ^ xml);public ProjectInstance (Microsoft.Build.Construction.ProjectRootElement xml);new Microsoft.Build.Execution.ProjectInstance : Microsoft.Build.Construction.ProjectRootElement -> Microsoft.Build.Execution.ProjectInstancePublic Sub New (xml As ProjectRootElement)Parameters
The project root element
Remarks
No intermediate Project object is created. This is useful if a project is going to be built, but not displayed or edited.
Applies to
ProjectInstance(String)
Creates a ProjectInstance directly. No intermediate Project object is created. This is ideal if the project is simply going to be built, and not displayed or edited. Uses the default project collection.
public:
ProjectInstance(System::String ^ projectFile);public ProjectInstance (string projectFile);[System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")]
public ProjectInstance (string projectFile);new Microsoft.Build.Execution.ProjectInstance : string -> Microsoft.Build.Execution.ProjectInstance[<System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")>]
new Microsoft.Build.Execution.ProjectInstance : string -> Microsoft.Build.Execution.ProjectInstancePublic Sub New (projectFile As String)Parameters
- projectFile
- String
The name of the project file.
- Attributes
Remarks
No intermediate Project object is created. This is useful if a project is going to be built, but not displayed or edited.
Applies to
ProjectInstance(Project, ProjectInstanceSettings)
Creates a ProjectInstance from an external created Project. Properties and items are cloned immediately and only the instance data is stored.
public:
ProjectInstance(Microsoft::Build::Evaluation::Project ^ project, Microsoft::Build::Execution::ProjectInstanceSettings settings);public ProjectInstance (Microsoft.Build.Evaluation.Project project, Microsoft.Build.Execution.ProjectInstanceSettings settings);new Microsoft.Build.Execution.ProjectInstance : Microsoft.Build.Evaluation.Project * Microsoft.Build.Execution.ProjectInstanceSettings -> Microsoft.Build.Execution.ProjectInstancePublic Sub New (project As Project, settings As ProjectInstanceSettings)Parameters
- project
- Project
- settings
- ProjectInstanceSettings
Applies to
ProjectInstance(String, IDictionary<String,String>, String)
Creates a ProjectInstance directly. No intermediate Project object is created. This is ideal if the project is simply going to be built, and not displayed or edited. Uses the default project collection.
public:
ProjectInstance(System::String ^ projectFile, System::Collections::Generic::IDictionary<System::String ^, System::String ^> ^ globalProperties, System::String ^ toolsVersion);public ProjectInstance (string projectFile, System.Collections.Generic.IDictionary<string,string> globalProperties, string toolsVersion);new Microsoft.Build.Execution.ProjectInstance : string * System.Collections.Generic.IDictionary<string, string> * string -> Microsoft.Build.Execution.ProjectInstancePublic Sub New (projectFile As String, globalProperties As IDictionary(Of String, String), toolsVersion As String)Parameters
- projectFile
- String
The name of the project file.
- globalProperties
- IDictionary<String,String>
The global properties to use.
- toolsVersion
- String
The tools version.
Remarks
No intermediate Project object is created. This is useful if a project is going to be built, but not displayed or edited.
Applies to
ProjectInstance(ProjectRootElement, IDictionary<String,String>, String, ProjectCollection)
Creates a ProjectInstance directly. No intermediate Project object is created. This is ideal if the project is simply going to be built, and not displayed or edited. Global properties may be null. Tools version may be null.
public:
ProjectInstance(Microsoft::Build::Construction::ProjectRootElement ^ xml, System::Collections::Generic::IDictionary<System::String ^, System::String ^> ^ globalProperties, System::String ^ toolsVersion, Microsoft::Build::Evaluation::ProjectCollection ^ projectCollection);public ProjectInstance (Microsoft.Build.Construction.ProjectRootElement xml, System.Collections.Generic.IDictionary<string,string> globalProperties, string toolsVersion, Microsoft.Build.Evaluation.ProjectCollection projectCollection);new Microsoft.Build.Execution.ProjectInstance : Microsoft.Build.Construction.ProjectRootElement * System.Collections.Generic.IDictionary<string, string> * string * Microsoft.Build.Evaluation.ProjectCollection -> Microsoft.Build.Execution.ProjectInstancePublic Sub New (xml As ProjectRootElement, globalProperties As IDictionary(Of String, String), toolsVersion As String, projectCollection As ProjectCollection)Parameters
The project root element
- globalProperties
- IDictionary<String,String>
The global properties to use.
- toolsVersion
- String
The tools version.
- projectCollection
- ProjectCollection
Project collection
Remarks
No intermediate Project object is created. This is useful if a project is going to be built, but not displayed or edited.
Applies to
ProjectInstance(String, IDictionary<String,String>, String, ProjectCollection)
Creates a ProjectInstance directly. No intermediate Project object is created. This is ideal if the project is simply going to be built, and not displayed or edited. Global properties may be null. Tools version may be null.
public:
ProjectInstance(System::String ^ projectFile, System::Collections::Generic::IDictionary<System::String ^, System::String ^> ^ globalProperties, System::String ^ toolsVersion, Microsoft::Build::Evaluation::ProjectCollection ^ projectCollection);public ProjectInstance (string projectFile, System.Collections.Generic.IDictionary<string,string> globalProperties, string toolsVersion, Microsoft.Build.Evaluation.ProjectCollection projectCollection);new Microsoft.Build.Execution.ProjectInstance : string * System.Collections.Generic.IDictionary<string, string> * string * Microsoft.Build.Evaluation.ProjectCollection -> Microsoft.Build.Execution.ProjectInstancePublic Sub New (projectFile As String, globalProperties As IDictionary(Of String, String), toolsVersion As String, projectCollection As ProjectCollection)Parameters
- projectFile
- String
The name of the project file.
- globalProperties
- IDictionary<String,String>
The global properties to use.
- toolsVersion
- String
The tools version.
- projectCollection
- ProjectCollection
Project collection
Remarks
No intermediate Project object is created. This is useful if a project is going to be built, but not displayed or edited.
Applies to
ProjectInstance(ProjectRootElement, IDictionary<String,String>, String, String, ProjectCollection)
Creates a ProjectInstance directly. No intermediate Project object is created. This is ideal if the project is simply going to be built, and not displayed or edited. Global properties may be null. Tools version may be null. Sub-toolset version may be null, but if specified will override all other methods of determining the sub-toolset.
public:
ProjectInstance(Microsoft::Build::Construction::ProjectRootElement ^ xml, System::Collections::Generic::IDictionary<System::String ^, System::String ^> ^ globalProperties, System::String ^ toolsVersion, System::String ^ subToolsetVersion, Microsoft::Build::Evaluation::ProjectCollection ^ projectCollection);public ProjectInstance (Microsoft.Build.Construction.ProjectRootElement xml, System.Collections.Generic.IDictionary<string,string> globalProperties, string toolsVersion, string subToolsetVersion, Microsoft.Build.Evaluation.ProjectCollection projectCollection);new Microsoft.Build.Execution.ProjectInstance : Microsoft.Build.Construction.ProjectRootElement * System.Collections.Generic.IDictionary<string, string> * string * string * Microsoft.Build.Evaluation.ProjectCollection -> Microsoft.Build.Execution.ProjectInstancePublic Sub New (xml As ProjectRootElement, globalProperties As IDictionary(Of String, String), toolsVersion As String, subToolsetVersion As String, projectCollection As ProjectCollection)Parameters
The project root element
- globalProperties
- IDictionary<String,String>
The global properties to use.
- toolsVersion
- String
The tools version.
- subToolsetVersion
- String
The sub-toolset version, used in tandem with the ToolsVersion to determine the set of toolset properties.
- projectCollection
- ProjectCollection
Project collection
Remarks
No intermediate Project object is created. This is useful if a project is going to be built, but not displayed or edited.
Applies to
ProjectInstance(String, IDictionary<String,String>, String, String, ProjectCollection)
Creates a ProjectInstance directly. No intermediate Project object is created. This is ideal if the project is simply going to be built, and not displayed or edited. Global properties may be null. Tools version may be null.
public:
ProjectInstance(System::String ^ projectFile, System::Collections::Generic::IDictionary<System::String ^, System::String ^> ^ globalProperties, System::String ^ toolsVersion, System::String ^ subToolsetVersion, Microsoft::Build::Evaluation::ProjectCollection ^ projectCollection);public ProjectInstance (string projectFile, System.Collections.Generic.IDictionary<string,string> globalProperties, string toolsVersion, string subToolsetVersion, Microsoft.Build.Evaluation.ProjectCollection projectCollection);new Microsoft.Build.Execution.ProjectInstance : string * System.Collections.Generic.IDictionary<string, string> * string * string * Microsoft.Build.Evaluation.ProjectCollection -> Microsoft.Build.Execution.ProjectInstancePublic Sub New (projectFile As String, globalProperties As IDictionary(Of String, String), toolsVersion As String, subToolsetVersion As String, projectCollection As ProjectCollection)Parameters
- projectFile
- String
The name of the project file.
- globalProperties
- IDictionary<String,String>
The global properties to use.
- toolsVersion
- String
The tools version.
- subToolsetVersion
- String
The sub-toolset version, used in tandem with the ToolsVersion to determine the set of toolset properties.
- projectCollection
- ProjectCollection
Project collection
Remarks
No intermediate Project object is created. This is useful if a project is going to be built, but not displayed or edited.