从WindowsAzure.Storage迁移至Azure.Data.Tables时，DynamicTableEntity类的作用及替代方案问询

我刚好对Azure Table Storage的SDK演进比较熟悉，帮你理清这个迁移中的关键点：

一、旧SDK中TableEntity与DynamicTableEntity的核心差异 #

在WindowsAzure.Storage或Microsoft.Azure.Cosmos.Table这类旧SDK里，这两个类的定位是明确区分的：

• DynamicTableEntity：主打动态无 schema 场景，不需要预先定义实体类，完全通过Properties字典来存储和读取任意列的属性。适合表结构不固定、需要灵活添加字段的场景，比如日志类数据或者多变的业务实体。
• TableEntity（旧版本）：主打强类型固定 schema 场景，需要你继承它并声明对应表列的强类型属性，SDK会基于这些属性自动完成序列化/反序列化。适合表结构稳定、需要编译期类型检查的业务场景。

二、Azure.Data.Tables v12中的等效替代方案 #

Azure.Data.Tables v12 SDK重构了实体模型，不再单独提供DynamicTableEntity，但它的Azure.Data.Tables.TableEntity已经融合了两者的能力——它既可以作为强类型实体的基类，也能像原来的DynamicTableEntity一样进行动态属性操作。

替代示例：从DynamicTableEntity迁移到TableEntity #

原来用DynamicTableEntity的代码：

// 旧SDK代码
using Microsoft.WindowsAzure.Storage.Table;

var dynamicEntity = new DynamicTableEntity("order-001", "item-100")
{
    Properties =
    {
        ["OrderDate"] = EntityProperty.GeneratePropertyForDateTime(DateTime.UtcNow),
        ["TotalAmount"] = EntityProperty.GeneratePropertyForDouble(99.9),
        ["IsPaid"] = EntityProperty.GeneratePropertyForBoolean(true)
    }
};

现在用Azure.Data.Tables的TableEntity替代，写法更简洁：

// Azure.Data.Tables v12代码
using Azure.Data.Tables;

var tableEntity = new TableEntity("order-001", "item-100")
{
    ["OrderDate"] = DateTime.UtcNow,
    ["TotalAmount"] = 99.9,
    ["IsPaid"] = true
};

// 读取动态属性也和原来逻辑一致
DateTime orderDate = (DateTime)tableEntity["OrderDate"];
bool isPaid = (bool)tableEntity["IsPaid"];

额外说明：强类型与动态模式的切换 #

如果你既需要强类型的类型安全，又偶尔要操作动态属性，v12的TableEntity也支持：

// 定义强类型实体
public class OrderEntity : TableEntity
{
    public DateTime OrderDate { get; set; }
    public double TotalAmount { get; set; }
    public bool IsPaid { get; set; }
}

// 实例化后依然可以动态添加额外属性
var order = new OrderEntity
{
    PartitionKey = "order-001",
    RowKey = "item-100",
    OrderDate = DateTime.UtcNow,
    TotalAmount = 99.9,
    IsPaid = true
};
order["Discount"] = 10.0; // 动态添加未在类中定义的字段

三、为什么v12去掉了DynamicTableEntity？ #

Azure团队在设计v12 SDK时，目标是简化API、减少冗余。原来分开的两个类功能有重叠，所以他们将动态属性访问的能力整合进了TableEntity，让一个类就能覆盖强类型和动态两种场景，降低了开发者的学习成本和代码复杂度。

内容的提问来源于stack exchange，提问作者sshh