Project.CreateProjectInstance Method
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 project instance based on this project, but completely disconnected from it.
Overloads
| CreateProjectInstance(ProjectInstanceSettings) |
Returns an instance based on this project, but completely disconnected. This instance can be used to build independently. Before creating the instance, this will reevaluate the project if necessary, so it will not be dirty. The instance is immutable; none of the objects that form it can be modified. This makes it safe to access concurrently from multiple threads. |
| CreateProjectInstance(ProjectInstanceSettings, EvaluationContext) | |
| CreateProjectInstance() |
Returns an instance based on this project, but completely disconnected. This instance can be used to build independently. Before creating the instance, this will reevaluate the project if necessary, so it will not be dirty. |
Remarks
Can be used to build independently. The original project is evaluated before creating the instance, if necessary, so that the original project is marked as unmodified.
CreateProjectInstance(ProjectInstanceSettings)
- Source:
- Project.cs
Returns an instance based on this project, but completely disconnected. This instance can be used to build independently. Before creating the instance, this will reevaluate the project if necessary, so it will not be dirty. The instance is immutable; none of the objects that form it can be modified. This makes it safe to access concurrently from multiple threads.
public:
Microsoft::Build::Execution::ProjectInstance ^ CreateProjectInstance(Microsoft::Build::Execution::ProjectInstanceSettings settings);public Microsoft.Build.Execution.ProjectInstance CreateProjectInstance (Microsoft.Build.Execution.ProjectInstanceSettings settings);member this.CreateProjectInstance : Microsoft.Build.Execution.ProjectInstanceSettings -> Microsoft.Build.Execution.ProjectInstancePublic Function CreateProjectInstance (settings As ProjectInstanceSettings) As ProjectInstanceParameters
- settings
- ProjectInstanceSettings
The project instance creation settings.
Returns
The created project instance.
Remarks
Can be used to build independently. The original project is evaluated before creating the instance, if necessary, so that the original project is marked as unmodified.
Applies to
CreateProjectInstance(ProjectInstanceSettings, EvaluationContext)
- Source:
- Project.cs
public:
Microsoft::Build::Execution::ProjectInstance ^ CreateProjectInstance(Microsoft::Build::Execution::ProjectInstanceSettings settings, Microsoft::Build::Evaluation::Context::EvaluationContext ^ evaluationContext);public Microsoft.Build.Execution.ProjectInstance CreateProjectInstance (Microsoft.Build.Execution.ProjectInstanceSettings settings, Microsoft.Build.Evaluation.Context.EvaluationContext evaluationContext);member this.CreateProjectInstance : Microsoft.Build.Execution.ProjectInstanceSettings * Microsoft.Build.Evaluation.Context.EvaluationContext -> Microsoft.Build.Execution.ProjectInstancePublic Function CreateProjectInstance (settings As ProjectInstanceSettings, evaluationContext As EvaluationContext) As ProjectInstanceParameters
- settings
- ProjectInstanceSettings
The project instance creation settings.
- evaluationContext
- EvaluationContext
The evaluation context to use in case reevaluation is required.
Returns
The created project instance.
Applies to
CreateProjectInstance()
- Source:
- Project.cs
Returns an instance based on this project, but completely disconnected. This instance can be used to build independently. Before creating the instance, this will reevaluate the project if necessary, so it will not be dirty.
public:
Microsoft::Build::Execution::ProjectInstance ^ CreateProjectInstance();public Microsoft.Build.Execution.ProjectInstance CreateProjectInstance ();member this.CreateProjectInstance : unit -> Microsoft.Build.Execution.ProjectInstancePublic Function CreateProjectInstance () As ProjectInstanceReturns
The created project instance.
Remarks
Can be used to build independently. The original project is evaluated before creating the instance, if necessary, so that the original project is marked as unmodified.