ProjectSettings.TryCapture
Section titled “ProjectSettings.TryCapture”
- Captures and validates the project-authored delta as one prospective Plugin contribution.
Required contracts
Section titled “Required contracts”API: engine
Project: Inno.Core.Settings
Declaration
Section titled “Declaration”public bool Inno.Core.Settings.ProjectSettings.TryCapture(Inno.Core.Settings.ProjectSettingId id, string contributorId, System.Collections.Generic.IReadOnlySet<string> declaredDependencies, System.Collections.Generic.IReadOnlySet<string> declaredOverrides, System.Collections.Generic.IReadOnlyList<Inno.Core.Settings.ProjectSettingsContributor> contributors, out Inno.Core.Settings.ProjectSettingRecord record)Parameters
Section titled “Parameters”Parameter id: Stable setting identifier.
Parameter contributorId: Stable identity of the Plugin being exported.
Parameter declaredDependencies: Direct dependency Plugin IDs declared by the exported Plugin.
Parameter declaredOverrides: Dependency Plugin IDs whose owned values may be replaced.
Parameter contributors: All currently active dependency-ordered contributors.
Parameter record: Receives the normalized semantic Plugin contribution.
Returns
Section titled “Returns”true when the project document contains an effective semantic delta.
Exceptions
Section titled “Exceptions”Exception T:System.InvalidOperationException: Thrown when a replacement setting depends on an undeclared contributor, or when the authored delta is not permitted by the declared dependency and override ownership.