ManagedProjectGraphCapture.CaptureSelectedAsync
Section titled “ManagedProjectGraphCapture.CaptureSelectedAsync”
- Evaluates a set of projects with the SDK already selected for this checkout. Multiple graph contexts can share one SDK selection.
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.CaptureSelectedAsync(string engineRoot, Inno.Build.Toolchains.DotNetSdkDescriptor sdk, 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 sdk: The descriptor returned by DotNetSdkResolver for the evaluation owner and its current SDK inputs.
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: Evaluator preparation or project evaluation fails.