The TranslateExtension class provides a WPF markup extension to enable declarative localization of UI strings in XAML. It allows developers to bind localized text to UI elements by referencing a resource key (e.g., {local:Translate CacheTime}), retrieving the corresponding string from the strongly-typed StringResources class. This avoids hardcoding English strings in XAML and supports runtime culture switching via StringResources.Culture. It exists to centralize and standardize string localization within the CachedItemsList module.
2. Public Interface
TranslateExtension(string key)
Constructor. Initializes the extension with the resource key (_key) to look up.
Parameter: key (string) – The resource key (e.g., "CacheTime", "Name"). Must match a key in the .resx file.
override object ProvideValue(IServiceProvider serviceProvider)
WPF markup extension entry point. Performs the resource lookup at runtime.
Behavior:
If _key is null or empty → returns "#stringnotfound#".
If a matching string is found → returns the localized string.
If no match is found → returns "#stringnotfound# " + _key (e.g., "#stringnotfound# UnknownKey").
3. Invariants
_key is immutable after construction (stored in a readonly field).
The returned value is always a string (enforced by [MarkupExtensionReturnType(typeof(string))]).
Lookup is case-sensitive (relies on ResourceManager.GetString, which performs exact key matching).
No fallback logic beyond the "#stringnotfound#" prefix; missing keys are not silently ignored.
Thread-safety: StringResources.ResourceManager is thread-safe (uses double-checked locking internally), but TranslateExtension itself does not enforce thread-safety for concurrent ProvideValue calls—though WPF typically invokes it on the UI thread.
XAML files in the CachedItemsList module (e.g., *.xaml pages referencing {local:Translate ...}).
No direct programmatic usage in the provided source; usage is exclusively via XAML markup.
5. Gotchas
Hardcoded fallback: The "#stringnotfound#" prefix is used verbatim for missing keys—this may cause UI clutter if keys are misspelled.
No null-safety for serviceProvider: The ProvideValue method does not validate serviceProvider (though WPF always provides a valid instance during XAML parsing).
Culture switching requires manual update: While StringResources.Culture can be set to switch languages, TranslateExtension does not auto-refresh when Culture changes; UI updates require re-evaluation (e.g., via property change notifications or re-rendering).
Key must match .resx keys exactly: Typos in XAML (e.g., {local:Translate Cache_Time} vs. "CacheTime") will trigger the fallback string.
No compile-time key validation: XAML keys are strings; invalid keys are only caught at runtime (when ProvideValue executes).
Auto-generated resource class: StringResources.Designer.cs is regenerated on build; manual edits will be lost. Resource keys must be managed in the .resx file.
No support for parameterized strings: The extension only retrieves static strings; it does not handle string.Format-style placeholders (e.g., "Hello {0}").
