ManagedProjectGraphCapture.CaptureAsync
Section titled “ManagedProjectGraphCapture.CaptureAsync”
- Captures effective properties, references, source items and imports using the shared SDK evaluator.
Required contracts
Section titled “Required contracts”API: engine
Project: Inno.Build.Toolchains
Declaration
Section titled “Declaration”public static System.Threading.Tasks.Task<string> Inno.Build.Toolchains.ManagedProjectGraphCapture.CaptureAsync(string engineRoot, string dotnetHost, System.Collections.Generic.IReadOnlyList<string> projects, System.Collections.Generic.IReadOnlyDictionary<string, string> properties, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken), bool resolveReferences = false)Parameters
Section titled “Parameters”Parameter engineRoot: The checkout owning the evaluator and its temporary request.
Parameter dotnetHost: The explicitly selected managed host executable.
Parameter projects: Existing absolute project paths evaluated together with identical global properties.
Parameter properties: The complete evaluation properties, including configuration and any explicit output owner.
Parameter cancellationToken: Cancels preparation or evaluation and drains child processes before releasing owners.
Parameter resolveReferences: Resolves compile references and implicit symbols after restore without building project references or native products.
Returns
Section titled “Returns”A JSON array of SDK snapshots. An empty request or failed evaluation throws instead of returning partial evidence.
Exceptions
Section titled “Exceptions”Exception T:System.ArgumentException: No projects are supplied or a project path is not absolute.
Exception T:System.IO.FileNotFoundException: A project or selected SDK input is absent.
Exception T:System.OperationCanceledException: The caller cancels owned work.
Exception T:System.InvalidOperationException: SDK discovery or evaluation fails.