DP44/docs/ai/Common/DTS.Common/Classes/ChannelCodes.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
Common/DTS.Common/Classes/ChannelCodes/TextPastedArgs.cs Common/DTS.Common/Classes/ChannelCodes/ChannelCode.cs	2026-04-17T16:07:14.970939+00:00	zai-org/GLM-5-FP8	1	fa1361db7a24ac6a

ChannelCodes

Purpose

This module provides the core domain model and event handling infrastructure for channel codes, which represent coded identifiers (User or ISO type) used in channel configuration. It includes the ChannelCode entity class, a PasteCommandClass for handling clipboard paste operations with multi-field parsing, and a delegate type for coercing ISO code values. The module supports data-driven construction from database readers and integrates with the Prism event aggregation system.

Public Interface

ChannelCode (class)

• Inherits from BasePropertyChanged, implements IChannelCode
• Constructors:
  • ChannelCode(IDataReader reader, IReadOnlyDictionary<short, string> channelTypeLookup) - Constructs from database reader, mapping CodeTypeInt to ChannelCodeType via lookup
  • ChannelCode() - Default constructor, sets CodeType to ISO
  • ChannelCode(IChannelCode channelCode) - Copy constructor
• Properties:
  • int Id - Unique identifier (default: -1)
  • UIItemStatus ItemStatus - UI state (default: UIItemStatus.None)
  • string Code - The channel code value
  • string Name - The channel name
  • ChannelEnumsAndConstants.ChannelCodeType CodeType - Either User or ISO
  • ICommand PasteCommand - Command for paste handling (default: null)
• Constants:
  • public const string PASTE_ID = "ChannelCode"
• Methods:
  • override bool Equals(object obj) - Equality based on Code, Name, and CodeType
• Destructor: ~ChannelCode() - Clears _code and _name to null

PasteCommandClass (class)

• Implements ICommand
• Constructor: PasteCommandClass(string id)
• Properties:
  • string Id { get; } - Identifier for the command instance
• Methods:
  • bool CanExecute(object parameter) - Always returns true
  • void Execute(object parameter) - Handles paste from clipboard; parses multi-field text, publishes TextPastedEvent or PageModifiedEvent
• Events:
  • event EventHandler CanExecuteChanged

TextPastedArgs (class)

• Implements ITextPastedEventArgs
• Constructor: TextPastedArgs(string text, IChannelCode channelCode, string id, object tag)
• Properties:
  • string Text { get; } - Pasted text content
  • object Sender { get; } - The IChannelCode source
  • string Id { get; } - Identifier
  • object Tag { get; } - Additional context

CoerceISOCodeDelegate (delegate)

• Signature: delegate string CoerceISOCodeDelegate(string val, bool uniqueISOCodesRequired, bool useISOCodeFilterMapping)
• Purpose: Coerces incoming ISO codes from UI to new values

Invariants

• ChannelCode.Id defaults to -1 when not set
• ChannelCode.Code and ChannelCode.Name are never null (initialized to string.Empty)
• PasteCommandClass.Execute only processes paste if Clipboard.ContainsText() returns true