C# 文件流讀寫結構體（一）：StructLayout 與佈局控制基礎

動機

需解析 .NET Micro Framework 字體文件頭部，希望像 C/C++ 一樣直接將文件流讀入結構體，避免逐字段解析。

佈局控制屬性

Explicit 佈局示例：聯合體

[StructLayout(LayoutKind.Explicit)]
struct TestUnion
{
    [FieldOffset(0)] public int i;
    [FieldOffset(0)] public double d;
    [FieldOffset(0)] public char c;
    [FieldOffset(0)] public byte b;
}
// 所有字段共享起始地址，類似 C union

Explicit 佈局示例：自定義偏移

[StructLayout(LayoutKind.Explicit)]
struct TestExplicit
{
    [FieldOffset(0)]  public long lg;   // 0-7
    [FieldOffset(0)]  public int i1;    // 0-3
    [FieldOffset(4)]  public int i2;    // 4-7
    [FieldOffset(8)]  public double d;  // 8-15
    [FieldOffset(16)] public char c;    // 16-17
    [FieldOffset(18)] public byte b;    // 18
}

Sequential 佈局（推薦大多數場景）

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Ansi, Pack = 1)]
public struct FontHeader
{
    public uint Version;      // 4
    public ushort FontCount;  // 2
    public ushort Height;     // 2
    // Pack=1 禁用對齊填充，確保與文件格式完全一致
}

關鍵參數 Pack

• 控制字段對齊邊界（1, 2, 4, 8, 16）。
• Pack=1 表示無填充，按順序緊湊排列，適合文件格式映射。
• 默認 Pack=0 跟隨平台（通常 8 字節對齊）。

後續預告

下一篇將展示完整的 Marshal 序列化/反序列化封裝、文件讀寫代碼、實測結構體與二進制文件映射案例。

1. 上一篇文章： C# 文件流讀寫結構體（二）：Marshal 序列化完整實現
2. 下一篇文章： C# 類成員初始化順序（三）：循環靜態依賴與結構體初始化

關於C語言

在 Code::Blocks 中搭建 MSP430 開發環境完整步驟

Code::Blocks 整合 MSP430-GCC 工具鏈

Lua 面向對象編程完全指南：原型繼承、元表機制、單/多重繼承與最佳實踐模式

Lua 無內置類，**通過表 + 元表 模擬原型繼承**實現

C語言文件操作詳解：數據流概念與順序/隨機讀寫函數完全指南

C語言文件操作詳解：數據流概念與順序/隨機讀寫函數完全指南

單晶片數碼管動態顯示原理與 C51 實作

硬體環境 實驗板：TX-1C 8 位共陰極數碼管，段選 P