C# 标准库类型

在 EasyBot 插件开发中，部分 API 会返回或接受 C# 的标准类型。这里列出了常见的 C# 类型及其 TypeScript 定义。

Dictionary<TKey, TValue>

C# 的字典类型，类似于 JavaScript 的 Map 或 Object。

定义

interface Dictionary<TKey, TValue> {
    // 索引器
    [key: string]: TValue;
    [key: number]: TValue;
}

说明

在 TypeScript 中，Dictionary 通常被映射为带有索引签名的对象。你可以像操作普通 JavaScript 对象一样操作它。

IList<T>

C# 的列表接口，类似于 JavaScript 的 Array，但提供了更多的方法。

定义

interface IList<T> {
    /** 元素的数量 */
    readonly Count: number;
    /** 是否只读 */
    readonly IsReadOnly: boolean;
    /** 获取指定索引的元素 */
    get(index: number): T;
    /** 设置指定索引的元素 */
    set(index: number, value: T): void;
    /** 添加元素 */
    Add(item: T): void;
    /** 清空列表 */
    Clear(): void;
    /** 是否包含元素 */
    Contains(item: T): boolean;
    /** 复制到数组 */
    CopyTo(array: T[], arrayIndex: number): void;
    /** 获取元素的索引 */
    IndexOf(item: T): number;
    /** 插入元素 */
    Insert(index: number, item: T): void;
    /** 移除元素 */
    Remove(item: T): boolean;
    /** 移除指定索引的元素 */
    RemoveAt(index: number): void;
}

常用方法

• Count: 获取列表长度。
• Add(item): 向列表末尾添加元素。
• get(index): 获取指定位置的元素。
• Remove(item): 移除特定元素。

IDisposable

用于释放非托管资源的接口。

定义

/**
 * 提供一种机制来释放未托管资源。
 */
interface IDisposable {
    /**
     * 释放、释放或重置非托管资源
     */
    Dispose(): void;
}

说明

如果一个对象实现了 IDisposable 接口，当你不再需要它时，应该调用 Dispose() 方法来释放资源。例如，在使用 HttpClient 或某些数据库连接时。

IEnumerator<T>

枚举器接口，用于遍历集合。

定义

interface IEnumerator<T> {
    /** 当前元素 */
    Current: T;
    /** 移动到下一个元素，如果成功则返回 true */
    MoveNext(): boolean;
    /** 重置枚举器 */
    Reset(): void;
}