DP44/enriched-qwen3-coder-next/DTS Viewer/DTS.Viewer.Modules/DTS.Viewer.Navigation/ViewModel.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
DTS Viewer/DTS.Viewer.Modules/DTS.Viewer.Navigation/ViewModel/NavigationViewModel.cs	2026-04-16T13:57:29.392045+00:00	zai-org/GLM-5-FP8	1	17ac7f526470fc92

Documentation: NavigationViewModel

1. Purpose

The NavigationViewModel class serves as the view model for the navigation component within the DTS Viewer application. It acts as a mediator between the INavigationView and the application's navigation infrastructure, managing the content displayed in the navigation region and handling notification events via Prism's IEventAggregator. This class inherits from BaseViewModel<INavigationViewModel> and implements INavigationViewModel, providing data binding context for the navigation view and supporting interaction requests for notifications and confirmations.

---

2. Public Interface

Constructor

public NavigationViewModel(INavigationView view, IRegionManager regionManager, IEventAggregator eventAggregator, IUnityContainer unityContainer)

Initializes a new instance of NavigationViewModel. Sets the view's DataContext to itself, creates new NotificationRequest and ConfirmationRequest instances, stores references to the event aggregator and Unity container, and subscribes to the RaiseNotification event.

---

Properties

Property	Type	Description
NavigationView	INavigationView	Gets the associated navigation view instance. Set once in constructor.
NotificationRequest	InteractionRequest<Notification>	Interaction request for displaying notifications to the user.
ConfirmationRequest	InteractionRequest<Confirmation>	Interaction request for displaying confirmation dialogs. Declared with new keyword.
ContextNavigationRegion	object	Gets or sets the content of the navigation region. Getter/setter directly access ((NavigationView)NavigationView).NavigationRegion.Content. Raises PropertyChanged on set.
HeaderInfo	string	Returns the constant string "NavigationRegion".
IsBusy	bool	Getter and setter both throw NotImplementedException. Declared with new keyword.
IsDirty	bool	Getter throws NotImplementedException. Declared with new keyword.
IsNavigationIncluded	bool	Get/set property. Declared with new keyword.

---

Methods

public override void Initialize()

Overrides base Initialize(). Empty implementation.

public override void Initialize(object parameter)

Overrides base Initialize(object). Casts parameter to IBaseViewModel and assigns it to the private Parent property.

---

Events

public new event PropertyChangedEventHandler PropertyChanged

Event for property change notifications. Declared with new keyword, hiding the base class event.

---

3. Invariants

• NavigationView is assigned exactly once in the constructor and is never null thereafter (assumes constructor parameter is non-null).
• NotificationRequest and ConfirmationRequest are instantiated in the constructor and remain non-null for the lifetime of the view model.
• The HeaderInfo property always returns the literal string "NavigationRegion".
• IsBusy and IsDirty properties will always throw NotImplementedException when accessed.
• The view model subscribes to RaiseNotification event during construction; the subscription persists for the object's lifetime.

---

4. Dependencies

This Module Depends On:

• DTS.Common.Base — Provides BaseViewModel<T> and IBaseViewModel
• DTS.Common.Events — Provides RaiseNotification event and NotificationContentEventArgs
• DTS.Common.Interactivity — Provides InteractionRequest<T>, Notification, Confirmation
• DTS.Common.Interface — Provides INavigationView, INavigationViewModel
• Prism.Events — Provides IEventAggregator
• Prism.Regions — Provides IRegionManager
• Unity — Provides IUnityContainer

What Depends On This Module:

• Cannot be determined from source alone. The INavigationViewModel interface suggests other modules may reference this view model through its interface abstraction.

---

5. Gotchas

1. Multiple new keyword usages: The properties ConfirmationRequest, IsBusy, IsDirty, IsNavigationIncluded, the PropertyChanged event, and the OnPropertyChanged method are all declared with new, hiding base class members. This indicates a design issue where the base class and derived class have conflicting member signatures. Callers casting to the base type will not see these overridden members.

2. NotImplementedException on IsBusy and IsDirty: Accessing either property will always throw. Code that attempts to bind to or check these properties will fail at runtime.

3. Unused ConfirmationRequest: The ConfirmationRequest property is instantiated but never raised anywhere in this class. It may be dead code or intended for future use.

4. Concrete type cast in ContextNavigationRegion: The property casts INavigationView NavigationView to the concrete type NavigationView to access NavigationRegion.Content. This breaks the interface abstraction and creates tight coupling to the concrete view implementation.

5. Parent property never used: The Parent property is set in Initialize(object parameter) but never referenced elsewhere in this file. Its purpose is unclear from source alone.

6. Suppressed ReSharper warnings: The file includes pragma-like comments suppressing warnings about unaccessed fields and unused auto-property accessors, suggesting known code quality issues that were silenced rather than resolved.