ProjectGraph.ProjectInstanceFactoryFunc Delegato

Definizione

Callback usato per costruire un oggetto ProjectInstance per un'istanza specifica di ProjectGraphEntryPoint.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 

Parametri

projectPath
String

Percorso del file di progetto da analizzare.The path to the project file to parse.

globalProperties
Dictionary<String,String>

Proprietà globali da usare per la creazione di ProjectInstance.The global properties to be used for creating the ProjectInstance.

projectCollection
ProjectCollection

Contesto ProjectCollection per l'analisi.The ProjectCollection context for parsing.

Valore restituito

ProjectInstance

Istanza di ProjectInstance.A ProjectInstance instance. Questo valore non deve essere Null.This value must not be null.

Commenti

La versione predefinita di questo delegato utilizzato da ProjectGraph chiama semplicemente il Costruttore ProjectInstance con le informazioni dei parametri.The default version of this delegate used by ProjectGraph simply calls the ProjectInstance constructor with information from the parameters. Questo delegato viene fornito come hook per consentire scenari come la creazione di un' Project istanza prima di convertirla in un ProjectInstance per l'uso da parte di 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. Il ProjectInstance restituito verrà archiviato e fornito con ProjectGraph.The returned ProjectInstance will be stored and provided with the ProjectGraph. Se questo callback sceglie di generare un ProjectInstance non modificabile, ad esempio usando CreateProjectInstance() con il flag Immutable , i nodi ProjectGraph risultanti potrebbero non essere compilabili.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. Per evitare il danneggiamento del grafico e delle compilazioni successive basate sul grafico:-tutti i parametri di callback devono essere utilizzati per la creazione di ProjectInstance, senza mutazioni. l'istanza del progetto non deve essere mutata in alcun modo, il suo stato deve essere una rappresentazione con fedeltà completa del file di progettoTo 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

Si applica a