Files
2026-04-17 14:55:32 -04:00

46 lines
3.2 KiB
Markdown

---
source_files:
- Common/DTS.Common.Storage/Properties/AssemblyInfo.cs
generated_at: "2026-04-16T11:53:53.492402+00:00"
model: "zai-org/GLM-5-FP8"
schema_version: 1
sha256: "4cfe76befa81e318"
---
# Documentation: DTS.Common.Storage Assembly Configuration
## 1. Purpose
This file provides assembly-level metadata and configuration for the `DTS.Common.Storage` component (compiled as "Storage.dll"). It defines the assembly's identity, version, and COM visibility settings. As a standard .NET assembly information file, it serves as the central manifest for the library's attributes within the broader "DTS.Common" namespace.
## 2. Public Interface
This file contains no public classes, methods, or functions. It strictly defines assembly-level attributes using C# attribute syntax.
**Defined Attributes:**
* **`AssemblyTitle`**: Set to `"Storage"`. Provides a friendly name for the assembly.
* **`AssemblyDescription`**: Set to an empty string. Intended for a summary of the assembly's purpose but currently undefined.
* **`AssemblyCompany`**: Set to an empty string.
* **`AssemblyProduct`**: Set to `"Storage"`.
* **`AssemblyCopyright`**: Set to `"Copyright © 2012"`.
* **`AssemblyCulture`**: Set to an empty string (neutral culture).
* **`ComVisible`**: Set to `false`. Prevents types within this assembly from being visible to COM components.
* **`Guid`**: Set to `"b62ab8e0-42f4-4a11-bad5-0add30baad84"`. A unique identifier for the assembly, required if COM interop is ever enabled.
* **`AssemblyVersion`**: Set to `"1.0.0.0"`. Defines the version number used by the CLR binding system.
* **`AssemblyFileVersion`**: Set to `"1.0.0.0"`. Defines the version number displayed in the file properties (Win32 file version resource).
## 3. Invariants
* **Version Consistency:** Both `AssemblyVersion` and `AssemblyFileVersion` are currently synchronized at `"1.0.0.0"`.
* **COM Visibility:** The assembly is explicitly configured to hide types from COM (`ComVisible(false)`). If specific types need to be exposed to COM later, this attribute must be set to `true` or overridden on specific classes.
* **Identity:** The `Guid` attribute provides a permanent unique identity for this specific assembly.
## 4. Dependencies
* **Internal Dependencies (Imports):**
* `System.Reflection`
* `System.Runtime.CompilerServices`
* `System.Runtime.InteropServices`
* **External Dependents:** Unknown from this source alone. Any project referencing the compiled `DTS.Common.Storage` assembly depends on the version and metadata defined here.
## 5. Gotchas
* **Legacy Timestamp:** The `AssemblyCopyright` attribute contains a hardcoded year of 2012, suggesting this is a legacy codebase that may not have been updated recently.
* **Missing Description:** The `AssemblyDescription` is empty. Developers investigating this assembly via tools or object browsers will not see a summary description of its purpose.
* **Hardcoded Version:** The version numbers are hardcoded to `1.0.0.0`. In modern CI/CD pipelines, this file typically requires patching during the build process to reflect accurate build numbers, or it should be migrated to a modern SDK-style project format where versioning is often handled in the project file (`.csproj`).