ProjectGraph.ProjectInstanceFactoryFunc Délégué

Définition

Rappel utilisé pour construire un ProjectInstance pour une instance ProjectGraphEntryPoint spécifique.A callback used for constructing a ProjectInstance for a specific ProjectGraphEntryPoint instance.

public: delegate Microsoft::Build::Execution::ProjectInstance ^ ProjectGraph::ProjectInstanceFactoryFunc(System::String ^ projectPath, Dictionary<System::String ^, System::String ^> ^ globalProperties, ProjectCollection ^ projectCollection);
public delegate Microsoft.Build.Execution.ProjectInstance ProjectGraph.ProjectInstanceFactoryFunc(string projectPath, Dictionary<string,string> globalProperties, ProjectCollection projectCollection);
type ProjectGraph.ProjectInstanceFactoryFunc = delegate of string * Dictionary<string, string> * ProjectCollection -> ProjectInstance
Public Delegate Function ProjectGraph.ProjectInstanceFactoryFunc(projectPath As String, globalProperties As Dictionary(Of String, String), projectCollection As ProjectCollection) As ProjectInstance 

Paramètres

projectPath
String

Chemin du fichier projet à analyser.The path to the project file to parse.

globalProperties
Dictionary<String,String>

Propriétés globales à utiliser pour créer la ProjectInstance.The global properties to be used for creating the ProjectInstance.

projectCollection
ProjectCollection

Contexte de ProjectCollection pour l’analyse.The ProjectCollection context for parsing.

Valeur renvoyée

ProjectInstance

Instance de ProjectInstance.A ProjectInstance instance. Cette valeur ne doit pas être Null.This value must not be null.

Remarques

La version par défaut de ce délégué utilisé par ProjectGraph appelle simplement le constructeur ProjectInstance avec les informations des paramètres.The default version of this delegate used by ProjectGraph simply calls the ProjectInstance constructor with information from the parameters. Ce délégué est fourni comme un Hook pour permettre des scénarios tels que la création d’une Project instance avant sa conversion en ProjectInstance pour une utilisation par ProjectGraph.This delegate is provided as a hook to allow scenarios like creating a Project instance before converting it to a ProjectInstance for use by the ProjectGraph. Le ProjectInstance retourné sera stocké et fourni avec ProjectGraph.The returned ProjectInstance will be stored and provided with the ProjectGraph. Si ce rappel choisit de générer un ProjectInstance immuable, par exemple en utilisant CreateProjectInstance() avec l’indicateur Immutable , les nœuds ProjectGraph résultants ne peuvent pas être générés.If this callback chooses to generate an immutable ProjectInstance, e.g. by using CreateProjectInstance() with the flag Immutable, the resulting ProjectGraph nodes might not be buildable. Pour éviter d’endommager le graphique et les builds ultérieures basées sur le graphique : tous les paramètres de rappel doivent être utilisés pour créer le ProjectInstance, sans aucune mutation. l’instance de projet ne doit pas être mutée de quelque façon que ce soit, son état doit être une représentation de fidélité complète du fichier projetTo avoid corruption of the graph and subsequent builds based on the graph: - all callback parameters must be utilized for creating the ProjectInstance, without any mutations - the project instance should not be mutated in any way, its state should be a full fidelity representation of the project file

S’applique à