46 lines
3.2 KiB
Markdown
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`).
|