DP44/enriched-qwen3-coder-next/DataPRO/Modules/Hardware/AddEditHardware/Resources.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
DataPRO/Modules/Hardware/AddEditHardware/Resources/TranslateExtension.cs DataPRO/Modules/Hardware/AddEditHardware/Resources/StringResources.Designer.cs	2026-04-16T04:36:34.790176+00:00	Qwen/Qwen3-Coder-Next-FP8	1	df6887e304a35dc7

Resources

Documentation: TranslateExtension Markup Extension

1. Purpose

This module provides a WPF MarkupExtension (TranslateExtension) that enables declarative localization of UI strings in XAML. It allows UI elements (e.g., TextBlock.Text, Button.Content) to bind to localized string resources defined in StringResources by specifying a resource key. Its role is to abstract away manual resource lookup and support runtime culture switching in the AddEditHardware module’s UI.

2. Public Interface

• TranslateExtension(string key)
  Constructor. Accepts a string key corresponding to a resource name in StringResources. Stores the key for later lookup.

• object ProvideValue(IServiceProvider serviceProvider)
  Overrides MarkupExtension.ProvideValue. Performs resource lookup at XAML load time:

  • Returns "#stringnotfound#" if _key is null or empty.
  • Returns the localized string from StringResources.ResourceManager.GetString(_key) if found.
  • Returns "#stringnotfound# <key>" (e.g., "#stringnotfound# MyKey") if the key is non-empty but no matching resource exists.

3. Invariants

• _key is immutable after construction (no setter or mutation).
• The extension always returns a string (per [MarkupExtensionReturnType(typeof(string))]).
• Lookup is case-sensitive (relies on ResourceManager.GetString(string) behavior).
• If a resource key is missing, the fallback string explicitly includes the original key for debugging visibility.

4. Dependencies

• Depends on:
  • System.Windows.Markup (for MarkupExtension base class).
  • AddEditHardware.Resources.StringResources (strongly-typed resource class generated from .resx).
  • System.Resources.ResourceManager (used internally via StringResources.ResourceManager).
• Used by:
  • XAML files in the AddEditHardware module (e.g., AddEditHardwareView.xaml) to localize UI elements.
  • No direct runtime dependencies beyond WPF framework and the StringResources assembly.

5. Gotchas

• Static resource resolution: ProvideValue is called once at XAML load time, not at runtime. Changing StringResources.Culture after XAML is parsed will not update already-bound UI elements.
• Fallback format: Missing keys yield "#stringnotfound# <key>", which may appear in UI if keys are misspelled or missing from .resx. This is intentional for debugging but may confuse end users.
• No null-safety for serviceProvider: The implementation does not validate serviceProvider, though WPF typically provides a valid instance.
• Hardcoded fallback: The "#stringnotfound#" prefix is hardcoded and not configurable.
• No async or caching optimization: Each usage triggers a ResourceManager.GetString() call; no caching is applied within TranslateExtension (though ResourceManager itself caches resources internally).
• Auto-generated resource class: StringResources is auto-generated; manual edits will be overwritten. Resource keys must match exactly (case-sensitive) with entries in the .resx file.

None identified beyond the above.