Class ExtensionSettingsAttribute
- Namespace
- RDCore.SDK.Extensibility
- Assembly
- RDCore.SDK.dll
Says which settings an extension is configured with: the type it binds them to, the section of the configuration they are in, and where they are described.
[AttributeUsage(AttributeTargets.Assembly, AllowMultiple = false)]
public sealed class ExtensionSettingsAttribute : Attribute
- Inheritance
-
ExtensionSettingsAttribute
- Inherited Members
Remarks
What this says is written into the extension's manifest when it is described (Describe(string, string)): a client knows the settings of every extension the platform has - offers them to a user, checks what is set - without starting any of them (Settings).
The settings type is read as the platform's are (SettingsSchema): when a change of a setting takes effect is what its SettingAttribute says, and a setting is described by the string of its key in DescriptionsResource, its dots written as underscores, in each language of the platform (Languages).
Constructors
ExtensionSettingsAttribute(Type, string, string)
Says which settings an extension is configured with: the type it binds them to, the section of the configuration they are in, and where they are described.
public ExtensionSettingsAttribute(Type optionsType, string section, string descriptionsResource)
Parameters
optionsTypeTypeThe type the settings are bound to.
sectionstringThe key of the section they are bound from, under Root:
Diagnostics.descriptionsResourcestringThe base name of the resources of the extension's assembly that describe them:
RDCore.Diagnostics.SettingDescriptions.
Remarks
What this says is written into the extension's manifest when it is described (Describe(string, string)): a client knows the settings of every extension the platform has - offers them to a user, checks what is set - without starting any of them (Settings).
The settings type is read as the platform's are (SettingsSchema): when a change of a setting takes effect is what its SettingAttribute says, and a setting is described by the string of its key in DescriptionsResource, its dots written as underscores, in each language of the platform (Languages).
Properties
DescriptionsResource
The base name of the resources of the extension's assembly that describe the settings.
public string DescriptionsResource { get; }
Property Value
OptionsType
The type the settings are bound to.
public Type OptionsType { get; }
Property Value
Section
The key of the section the settings are bound from, under Root.
public string Section { get; }