33 lines
2.8 KiB
Markdown
33 lines
2.8 KiB
Markdown
---
|
||
source_files:
|
||
- Common/DTS.Common.IConnection/USBConnection/HIDUSBConnection/Properties/AssemblyInfo.cs
|
||
generated_at: "2026-04-16T02:10:22.587640+00:00"
|
||
model: "Qwen/Qwen3-Coder-Next-FP8"
|
||
schema_version: 1
|
||
sha256: "1fcf58774b015c19"
|
||
---
|
||
|
||
# Properties
|
||
|
||
## 1. Purpose
|
||
This file is an assembly-level metadata configuration file (`AssemblyInfo.cs`) for the `DTS.Common.IConnection.USBConnection.HIDUSBConnection` .NET assembly. Its purpose is to define assembly-wide attributes such as title, version, COM visibility, and GUID—used for identification, versioning, and interoperability—but it does *not* contain any executable logic, interfaces, or types. It serves as infrastructure metadata required by the .NET build system and COM interop layer, with no runtime behavior or public API surface.
|
||
|
||
## 2. Public Interface
|
||
**None.**
|
||
This file contains only assembly-level attributes and no public types (classes, structs, interfaces, enums), methods, properties, or fields. All content is metadata declarations via `Assembly*` attributes.
|
||
|
||
## 3. Invariants
|
||
- The assembly is **not visible to COM** (`ComVisible(false)`), meaning its types cannot be accessed via COM unless explicitly exposed elsewhere.
|
||
- The assembly’s version is fixed at **1.06.0081** for both `AssemblyVersion` and `AssemblyFileVersion`.
|
||
- The assembly’s GUID is **`9127ae79-928b-4187-a425-97f49034c5ad`**, used for COM type library identification (though irrelevant here due to `ComVisible(false)`).
|
||
- No runtime invariants apply, as this file contributes no executable code.
|
||
|
||
## 4. Dependencies
|
||
- **Dependencies**: None (this file has no external dependencies beyond the .NET Framework’s `System.Reflection`, `System.Runtime.CompilerServices`, and `System.Runtime.InteropServices` namespaces, which are implicitly available).
|
||
- **Depended upon**: None directly—this file is consumed by the build system and runtime metadata infrastructure, not by application code. Other modules in the `DTS.Common.IConnection` hierarchy may reference this assembly, but they do not depend on its metadata content.
|
||
|
||
## 5. Gotchas
|
||
- **Versioning nuance**: `AssemblyVersion` (`1.06.0081`) controls binding redirects and assembly identity at runtime, while `AssemblyFileVersion` is informational (used for file properties in Windows). Changing only `AssemblyFileVersion` does *not* affect runtime binding.
|
||
- **COM irrelevance**: Despite the explicit `Guid` attribute, `ComVisible(false)` renders the GUID unused for COM registration. If COM interop is needed, `ComVisible(true)` must be set *and* types must be explicitly marked with `ComVisible(true)`.
|
||
- **No functional impact**: Modifying or deleting this file will not break runtime logic but may cause build warnings or break COM registration tooling (e.g., `regasm`) if used.
|
||
- **Historical date**: Copyright year is set to 2008; verify if this reflects current ownership or is legacy. |