跳到主要内容

值类型

enum、struct、Nullable<T> 均为值类型相关形态。行为以 Struct Marshal、Enum Marshal 为准。

需要 plain object / UnpackedValues / Opaque 等少分配套路时，见 TsMarshalAs、少 GC Marshal。

形态对照​

类型默认跨边界形态构造实例
enum整数 number（常量）无 new EnumType(...)；boxed 仅用 zts.box
structByVal exotic 等（见规范）new Type(...) / Type._default()
Nullable<T>有值同 T；无值 → null / undefined（见默认矩阵）—

默认 不能 用 { X: 1, Y: 2 } 或 foo(x, y) 组装 struct 传入 C#，须 new Type(...) / ByVal exotic，或显式 [TsMarshalAs(Table|UnpackedValues)]。

enum​

跨边界默认就是 整数 number（类型对象上的常量也是 number，不是 exotic）：

const Color = CSharp.AC['MyGame.Color'];
console.log(Color.Red);           // 整型值，非 exotic
host.SetColor(Color.Red);
host.SetColor(1);                  // underlying 整型亦可

比较常量时用 number，不要当对象比。类型对象 无 [[Construct]]，不要写 new Color(...)。

需要 boxed 枚举（如部分 object 形参）时，只用 zts.box：

const boxed = zts.box(Color, Color.Red);
const boxed2 = zts.box(Color, 2);
console.log(zts.unbox(boxed));     // underlying number

禁止 bigint。细则见 Enum Marshal。

struct​

const Point2D = CSharp.AC['MyGame.Point2D'];
const origin = Point2D._default();
const p = new Point2D(3, 4);
p.X = 10;
p.Y = 20;
传递C# 形参行为
ByVal exotic（如 new Point2D(...)）by-val Point2D拷贝
同型 ByVal exoticref / out / in Point2D真 ref，可写回
形态典型来源成员访问
OpaqueValueC#→JS byref / 同步链临时无 .；用 get/set opaque
ByVal exoticnew Type(...)、to_user_dataByVal IEO
ByObj exoticzts.box、装箱路径ByObj IEO

静态成员经类型对象访问；struct 无继承。ref struct 不作普通 by-val。

Nullable<T>​

  • C# 无值 ↔ JS null /（可选槽位）undefined
  • 有值时按底层 T 的规则 Marshal
  • 不要给非 Nullable 的值类型传 null/undefined

完整示例（示意）​

namespace MyGame
{
    public enum Team { None = 0, Red = 1, Blue = 2 }

    public struct Vec2
    {
        public float X, Y;
        public Vec2(float x, float y) { X = x; Y = y; }
        public static float Dot(Vec2 a, Vec2 b) => a.X * b.X + a.Y * b.Y;
    }
}
const Team = CSharp.AC['MyGame.Team'];
const Vec2 = CSharp.AC['MyGame.Vec2'];
console.log(Team.Red);
console.log(Vec2.Dot(new Vec2(1, 0), new Vec2(0, 1)));

常见错误​

现象处理
enum 当对象比较失败用 integer number 比较
new Color(...) 失败enum 无构造；传整型，或 zts.box
struct 修改未回写by-val 拷贝；对 ref 传入同型 ByVal exotic 或 Opaque
{X,Y} 传入未标注的 struct标 Table（见 TsMarshalAs），或先 new Type(...)
foo(x,y) 传入未标注的 struct标 UnpackedValues（见 少 GC Marshal）
ref struct 作 by-val不支持

相关文档​