DP44/enriched-qwen3-coder-next/DataPRO/Modules/Groups/GroupList/Resources.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
DataPRO/Modules/Groups/GroupList/Resources/TranslateExtension.cs DataPRO/Modules/Groups/GroupList/Resources/StringResources.Designer.cs	2026-04-16T04:47:13.405699+00:00	Qwen/Qwen3-Coder-Next-FP8	1	30656f2a830a5a31

Resources

Documentation: TranslateExtension Markup Extension

---

1. Purpose

This module provides a WPF MarkupExtension (TranslateExtension) to enable declarative, data-bound localization of UI strings directly in XAML. It allows developers to reference localized string resources by key (e.g., {local:Translate Name}) and automatically retrieve the appropriate localized value at runtime from the StringResources resource class. Its role is to bridge XAML markup with the application’s resource management system, supporting multi-language UI without requiring code-behind or manual string lookups.

---

2. Public Interface

TranslateExtension class

• Namespace: GroupList
• Base class: System.Windows.Markup.MarkupExtension
• Attributes:
  • [MarkupExtensionReturnType(typeof(string))] — Indicates the extension returns a string.

Constructor

• TranslateExtension(string key)
  Initializes a new instance with the specified resource key. The key is stored in the private readonly field _key.
  • Parameter: key — The string key used to look up a localized resource (e.g., "Name", "Description").
  • Behavior: Validates key is non-null/non-empty at runtime during ProvideValue (not in constructor).

Overridden Method

• public override object ProvideValue(IServiceProvider serviceProvider)
  Returns the localized string for _key, or a fallback value if the key is missing or lookup fails.
  • Behavior:
    • If _key is null or empty → returns "#stringnotfound#".
    • Otherwise, calls StringResources.ResourceManager.GetString(_key).
      • If the result is non-null → returns the localized string.
      • If the result is null → returns "#stringnotfound# " + _key (e.g., "#stringnotfound# MissingKey").
  • Note: The serviceProvider parameter is unused in the implementation.

---

3. Invariants

• Resource key must be a valid string resource name (e.g., "Name", "Channels"). Invalid keys (e.g., "UnknownKey") will not throw but will return the fallback string "#stringnotfound# UnknownKey".
• Case sensitivity: Resource keys are case-sensitive (e.g., "name" ≠ "Name").
• No runtime exceptions are thrown for missing keys; the extension gracefully degrades to the NotFound prefix.
• Thread-safety: Relies on StringResources.ResourceManager, which is thread-safe per .NET documentation (uses lazy initialization and locking internally).
• XAML-only usage: Intended for use in XAML markup only; not designed for programmatic invocation outside markup extension context.

---

4. Dependencies

Dependencies on this module:

• WPF framework: Requires System.Windows.Markup and System.Windows (for MarkupExtension).
• StringResources class:
  • Defined in GroupList.Resources namespace.
  • Auto-generated from .resx files (not shown here, but implied by StringResources.Designer.cs).
  • Provides the underlying ResourceManager and strongly-typed properties (e.g., StringResources.Name).
• No external third-party dependencies beyond .NET Framework 4.0+ (per runtime version in StringResources.Designer.cs).

Dependencies of this module:

• None beyond standard WPF/.NET Framework types.
• Consumers: Any XAML file in the GroupList module (e.g., GroupList/Resources/TranslateExtension.cs is likely used in *.xaml files in the same module) to localize UI elements.

---

5. Gotchas

• No compile-time safety for keys: Using an incorrect key (e.g., "Nam" instead of "Name") will not cause a compile error—only a runtime fallback string (#stringnotfound# Nam).
• No culture switching support in extension itself: While StringResources.Culture can be set globally (e.g., via Thread.CurrentThread.CurrentUICulture), the extension does not expose or manage culture selection.
• Hardcoded fallback string: The "#stringnotfound#" prefix is fixed and may be visible to end-users if keys are missing.
• No validation of key format: Keys like "" (empty string) or " " (whitespace) are treated as invalid and return NotFound, but no explicit error logging occurs.
• Auto-generated resource class: StringResources.Designer.cs is auto-generated; manual edits will be overwritten. Resource keys must match entries in the corresponding .resx file (not visible here).
• No support for parameterized strings: The extension only supports simple key-based lookups (e.g., "{local:Translate Name}"). It cannot handle format strings like "{0} is {1}" (e.g., String.Format-style substitution).

None identified beyond the above.