48 lines
3.0 KiB
Markdown
48 lines
3.0 KiB
Markdown
|
---
|
||
|
|
source_files:
|
||
|
|
- Common/DTS.Common.IConnection/USBConnection/WINUSBConnection/Properties/AssemblyInfo.cs
|
||
|
|
generated_at: "2026-04-16T11:51:53.479173+00:00"
|
||
|
|
model: "zai-org/GLM-5-FP8"
|
||
|
|
schema_version: 1
|
||
|
|
sha256: "8875c5ea92f3aea7"
|
||
|
|
---
|
||
|
|
|
||
|
|
# Documentation: WINUSBConnection Assembly Info
|
||
|
|
|
||
|
|
## 1. Purpose
|
||
|
|
This file configures assembly-level metadata for the `WINUSBConnection` component within the `DTS.Common.IConnection` namespace. It establishes the assembly's identity, version, and COM visibility settings, serving as the manifest definition for the compiled output. This module exists to provide versioning and attribution information for the WinUSB connection library.
|
||
|
|
|
||
|
|
## 2. Public Interface
|
||
|
|
This file contains no executable public classes, methods, or functions. It strictly defines assembly-level attributes using C# attribute syntax.
|
||
|
|
|
||
|
|
**Defined Attributes:**
|
||
|
|
|
||
|
|
* **`AssemblyTitle`**: Set to `"WINUSBConnection"`.
|
||
|
|
* **`AssemblyDescription`**: Set to an empty string.
|
||
|
|
* **`AssemblyConfiguration`**: Set to an empty string.
|
||
|
|
* **`AssemblyCompany`**: Set to an empty string.
|
||
|
|
* **`AssemblyProduct`**: Set to `"WINUSBConnection"`.
|
||
|
|
* **`AssemblyCopyright`**: Set to `"Copyright © 2008"`.
|
||
|
|
* **`AssemblyTrademark`**: Set to an empty string.
|
||
|
|
* **`AssemblyCulture`**: Set to an empty string.
|
||
|
|
* **`ComVisible`**: Set to `false`. Prevents types in this assembly from being visible to COM components.
|
||
|
|
* **`Guid`**: Set to `"F3C369E6-BFFB-41bc-B8E8-A31094CED447"`. Identifies the Type Library ID if the project is exposed to COM.
|
||
|
|
* **`AssemblyVersion`**: Set to `"1.06.0081"`.
|
||
|
|
* **`AssemblyFileVersion`**: Set to `"1.06.0081"`.
|
||
|
|
|
||
|
|
## 3. Invariants
|
||
|
|
* **Version Consistency:** The `AssemblyVersion` and `AssemblyFileVersion` are explicitly synchronized at `"1.06.0081"`.
|
||
|
|
* **COM Visibility:** The assembly is explicitly marked as not visible to COM (`ComVisible(false)`). This must be overridden at the type level if specific types need COM exposure.
|
||
|
|
* **Identity:** The `Guid` attribute provides a unique identifier for this specific assembly's type library.
|
||
|
|
|
||
|
|
## 4. Dependencies
|
||
|
|
* **Imports:**
|
||
|
|
* `System.Reflection`
|
||
|
|
* `System.Runtime.CompilerServices`
|
||
|
|
* `System.Runtime.InteropServices`
|
||
|
|
* **Consumers:** Any project or reference that depends on the `WINUSBConnection` assembly relies on this file for correct versioning and assembly identity resolution.
|
||
|
|
|
||
|
|
## 5. Gotchas
|
||
|
|
* **Missing Metadata:** The `AssemblyDescription`, `AssemblyCompany`, and `AssemblyConfiguration` attributes are empty. This may result in missing information in assembly property dialogs or automated documentation generation.
|
||
|
|
* **Legacy Date:** The `AssemblyCopyright` attribute lists the year 2008. It is unclear if this is historical or if the metadata has not been updated to reflect current ownership/year.
|
||
|
|
* **Hardcoded Version:** The version `1.06.0081` is hardcoded. Unlike the commented-out suggestion in the source (`"*"` for auto-generation), the build and revision numbers are fixed, requiring manual updates for new releases.
|