DP44/enriched-partialglm/DTS Viewer/DTS.Viewer/Properties.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
DTS Viewer/DTS.Viewer/Properties/Settings.Designer.cs DTS Viewer/DTS.Viewer/Properties/AssemblyInfo.cs DTS Viewer/DTS.Viewer/Properties/Resources.Designer.cs	2026-04-16T11:23:58.003501+00:00	zai-org/GLM-5-FP8	1	06945b304ce6ac54

Documentation: DTS.Viewer.Properties

1. Purpose

This module provides the auto-generated infrastructure for application settings, localized resource management, and assembly metadata for the DTS.Viewer application. It acts as the configuration and identity layer, enabling strongly-typed access to user preferences via the Settings class and culture-specific resource lookups via the Resources class. The AssemblyInfo.cs file defines the application's version, company attribution (Diversified Technical Systems, Inc.), and WPF theme resource locations.

2. Public Interface

Class: DTS.Viewer.Properties.Settings

• Signature: internal sealed partial class Settings : global::System.Configuration.ApplicationSettingsBase
• Properties:
  • public static Settings Default { get; }: Returns the singleton instance of the application settings wrapper. This is the primary entry point for accessing application settings.
• Behavior: Provides a thread-safe singleton wrapper for application configuration. Note that the provided source contains no custom setting properties; they must be defined in the associated .settings file and regenerated into this partial class.

Class: DTS.Viewer.Properties.Resources

• Signature: internal class Resources
• Properties:
  • internal static global::System.Resources.ResourceManager ResourceManager { get; }: Returns the cached ResourceManager instance responsible for looking up localized resources (strings, images, etc.) within the "DTS.Viewer.Properties.Resources" scope.
  • internal static global::System.Globalization.CultureInfo Culture { get; set; }: Gets or sets the current CultureInfo used for resource lookups. Overrides the thread's current UI culture for this resource manager.
• Behavior: Acts as a strongly-typed proxy for .resx files. Like the Settings class, the provided source shows only the infrastructure; specific resource properties (e.g., string constants) are auto-generated into this class based on the .resx content.

Assembly Attributes (AssemblyInfo.cs)

• Identity:
  • [assembly: AssemblyTitle("DTS.Viewer")]
  • [assembly: AssemblyCompany("Diversified Technical Systems, Inc. (DTS)")]
• Versioning:
  • [assembly: AssemblyVersion("1.0.0.0")]
  • [assembly: AssemblyFileVersion("1.0.0.0")]
• COM Visibility: [assembly: ComVisible(false)] — Types are not visible to COM components.
• Theming: [assembly: ThemeInfo(...)] — Configures WPF to look for generic resource dictionaries in the source assembly.

3. Invariants

• Singleton Guarantee: The Settings.Default property is guaranteed to return a synchronized, thread-safe instance of the Settings class (enforced by ApplicationSettingsBase.Synchronized).
• Lazy Initialization: The Resources.ResourceManager property is lazily initialized; the internal resourceMan field remains null until the property is first accessed.
• Code Generation: Both Settings and Resources are marked with GeneratedCodeAttribute. Manual edits to these files will be overwritten by the tooling (Visual Studio Settings Designer or ResGen) during the next regeneration.

4. Dependencies

Dependencies of this Module

• System.Configuration: Required for ApplicationSettingsBase (used by Settings).
• System.Resources: Required for ResourceManager (used by Resources).
• System.Globalization: Required for CultureInfo (used by Resources).
• System.Windows: Required for ResourceDictionaryLocation (used in AssemblyInfo.cs for WPF theming).
• System.Reflection, System.Runtime.InteropServices: Required for assembly-level metadata attributes.

Dependents of this Module

• DTS.Viewer Assembly: All code within the DTS.Viewer project relies on Properties.Settings.Default for configuration persistence and Properties.Resources for localized strings and assets.

5. Gotchas

• Auto-Generated Code Warning: The source files Settings.Designer.cs and Resources.Designer.cs contain explicit warnings that manual changes will be lost. Developers must modify the underlying XML files (.settings and .resx) rather than the C# source.
• Missing Custom Properties: The provided source for Settings and Resources contains only the infrastructure code (singleton pattern and resource manager plumbing). No actual user settings or resource strings are visible in the provided text; this implies the specific data values are defined elsewhere (in XML) and injected during the build process.
• Template Copyright: The AssemblyInfo.cs file contains AssemblyCopyright("Copyright © Microsoft 2016"). This appears to be a default Visual Studio template value that was not updated to reflect the actual company ("Diversified Technical Systems, Inc. (DTS)").
• Internal Visibility: Both Settings and Resources are marked internal, meaning they are not accessible outside the DTS.Viewer assembly.