DP44/enriched-qwen3-coder-next/DataPRO/Modules/ISO/ExtraProperties.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
DataPRO/Modules/ISO/ExtraProperties/ExtraPropertiesModule.cs	2026-04-16T04:38:16.817195+00:00	Qwen/Qwen3-Coder-Next-FP8	1	02a142220d3db719

ExtraProperties

Documentation: ExtraPropertiesModule

1. Purpose

The ExtraPropertiesModule is a Prism module responsible for registering the view and view model components for the Extra Properties feature within the application’s UI. It integrates with the Unity dependency injection container to expose IExtraPropertiesListView and IExtraPropertiesListViewModel as singleton services, enabling modular, testable, and decoupled UI construction. Additionally, it contributes assembly-level metadata (name, image, group, region) via custom attributes (ExtraPropertiesModuleNameAttribute, ExtraPropertiesModuleImageAttribute) to support dynamic UI composition—specifically, for display on the main screen’s summary of available modules.

2. Public Interface

ExtraPropertiesModule class

• ExtraPropertiesModule(IUnityContainer unityContainer)
  Constructor. Accepts a Unity container via dependency injection and stores it for later use in type registration.
• void Initialize()
  Registers two types as singletons in the Unity container:
  • IExtraPropertiesListViewModel → ExtraPropertiesListViewModel
  • IExtraPropertiesListView → ExtraPropertiesListView
    This method is called both directly during module initialization and via RegisterTypes.
• void OnInitialized(IContainerProvider containerProvider)
  Currently empty; no logic implemented.
• void RegisterTypes(IContainerRegistry containerRegistry)
  Delegates to Initialize() (despite receiving a IContainerRegistry, it uses the injected IUnityContainer instead).

ExtraPropertiesModuleNameAttribute class

• ExtraPropertiesModuleNameAttribute() / ExtraPropertiesModuleNameAttribute(string s)
  Constructor; ignores the string s parameter. Sets AssemblyName to AssemblyNames.ExtraProperties.ToString().
• string AssemblyName { get; }
  Returns "ExtraProperties" (value of AssemblyNames.ExtraProperties.ToString()).
• Type GetAttributeType()
  Returns typeof(TextAttribute).
• string GetAssemblyName()
  Returns AssemblyName.

ExtraPropertiesModuleImageAttribute class

• ExtraPropertiesModuleImageAttribute() / ExtraPropertiesModuleImageAttribute(string s)
  Constructor; initializes _img by calling AssemblyInfo.GetImage("ExtraProperties").
• BitmapImage AssemblyImage { get; }
  Returns the image retrieved via AssemblyInfo.GetImage("ExtraProperties").
• string AssemblyName { get; }
  Returns "ExtraProperties".
• string AssemblyGroup { get; }
  Returns "Prepare" (value of eAssemblyGroups.Prepare.ToString()).
• eAssemblyRegion AssemblyRegion { get; }
  Returns eAssemblyRegion.ExtraPropertiesRegion.
• Type GetAttributeType()
  Returns typeof(ImageAttribute).
• BitmapImage GetAssemblyImage() / string GetAssemblyName() / string GetAssemblyGroup() / eAssemblyRegion GetAssemblyRegion()
  Public overrides returning the corresponding property values.

3. Invariants

• AssemblyName for both attributes is strictly "ExtraProperties" (derived from AssemblyNames.ExtraProperties).
• AssemblyGroup is strictly "Prepare" (derived from eAssemblyGroups.Prepare).
• AssemblyRegion is strictly eAssemblyRegion.ExtraPropertiesRegion.
• The ExtraPropertiesListView and ExtraPropertiesListViewModel types are registered as singleton instances in the Unity container during module initialization.
• Both attributes are assembly-level (AttributeTargets.Assembly), non-repeatable (AllowMultiple = false), and must be applied exactly once per assembly.

4. Dependencies

Depends on:

• Unity (via IUnityContainer, Unity namespace)
• Prism.Modularity (via IModule, ModuleAttribute)
• Prism.Ioc (via IContainerRegistry, IContainerProvider)
• DTS.Common.Interface.ISO.ExtraProperties (via IExtraPropertiesListView, IExtraPropertiesListViewModel)
• DTS.Common (via AssemblyNames, eAssemblyGroups, eAssemblyRegion, AssemblyInfo)
• System.Windows.Media.Imaging (via BitmapImage)
• System.ComponentModel.Composition (via ExportAttribute)

Used by:

• The Prism bootstrapper/container infrastructure (to discover and load ExtraPropertiesModule as an IModule).
• The UI composition layer (to retrieve module metadata—name, image, group, region—via reflection on the assembly attributes).

5. Gotchas

• RegisterTypes ignores its parameter: Despite receiving IContainerRegistry, RegisterTypes calls Initialize(), which uses the injected IUnityContainer instead. This tightly couples the module to Unity and breaks Prism’s abstraction (e.g., it would fail if used with a different DI container).
• Redundant attribute usage: Both ExtraPropertiesModuleNameAttribute and ExtraPropertiesModuleImageAttribute are applied at the assembly level (via [assembly: ...]), but their constructors accept an unused string parameter—likely legacy or placeholder.
• No error handling in image loading: AssemblyInfo.GetImage(...) is called in the constructor and property getter of ExtraPropertiesModuleImageAttribute. If the image resource is missing or malformed, this could cause runtime exceptions during assembly loading or attribute enumeration.
• OnInitialized is empty: Suggests incomplete implementation or deferred logic.
• No validation of view/view-model types: Assumes ExtraPropertiesListView and ExtraPropertiesListViewModel exist and implement their respective interfaces. A mismatch would only surface at runtime during resolution.
• No documentation for AssemblyNames, eAssemblyGroups, eAssemblyRegion, or AssemblyInfo: These types are referenced but not defined in this file; their values and constraints are inferred solely from usage.