ea412b24ec
* fix: DataIndex access maybe null object * feat: access object's property by path-based string * doc: update Table DataIndex demo * doc: correct Table/demo/custom-row-style.md file encoding Co-authored-by: James Yeung <shunjiey@hotmail.com>
3.9 KiB
| order | title |
|---|---|
| 5 | 路径式属性访问 |
提供 PropertyAccessHelper 以实现通过属性路径字符串来访问对象的属性及其后代属性。
支持的操作
1. 访问后代属性
例："A.B.C"。
2. 数组模式索引，以及实现了 Count 属性和 get_Item(int) (即 this[int] 方法的 类似 List 的 类型
例："A.B[1].C"。
3. 字典模式索引，以及实现了 ContainsKey 方法和 get_Item (即 this[key]) 方法的 类似 Dictionary 的 类型。
例："A.B[\"test\"].C"。
4. 数组、字典嵌套
例："A.B[\"test\"][3].C"，"A.B[1][5].C"，"A.B[1][\"user id\"].C"。
5. 非空模式和可空模式
5.1. 非空模式
⚠注意：非空模式下需要开发者保证属性路径上的属性不为null，如果包含数组模式或字典模式，还需要保证索引对象必须存在，否则访问不存在的对象的属性时会抛出异常。
当结果数据类型是值类型且不是Nullable时(如int)，会生成直接访问表达式，如果属性路径中存在Nullable类型，会不做null检查直接访问。
如：访问属性A.B.C 时，其中 B 是 Nullable<MyStruct>，会生成类似 A.B!.Value.C 的表达式。
对于数组或字典，会直接访问，如：访问数组对象属性 A.B[i].C 时，不会检查 B.Count > i && i > 0 。访问字典对象属性 A.D["my data"].C 时，不会检查 D.ContainsKey("my data")。
5.2. 可空模式
可空模式下不需要保证数据不为null，也不用保证数组模式或字典模式必定有值，访问到不存在对象的属性时会返回null。
当结果数据类型是Nullable值类型或class时(如int?, string)，会生成条件表达式，如果属性路径中存在Nullable或class类型，会先检查非null再访问，遇到null对象会返回null。
如：访问属性 A.B.C 时，其中 B 是 Nullable<MyStruct>，会生成类似 A.B.HasValue ? A.B.Value.C : null 的表达式。
对于数组或字典，会先检查再访问，如：访问数组对象属性 A.B[i].C 时，会检查 B.Count > i && i > 0 , 结果是 false 时返回 null 。访问字典对象属性 A.D["my data"].C 时，会检查 D.ContainsKey("my data"), 结果是 false 时返回 null 。
API
| 方法 | 说明 |
|---|---|
| BuildAccessPropertyLambdaExpression | 创建非空属性访问Lambda表达式, 调用Compile()后即可使用 |
| BuildAccessNullablePropertyLambdaExpression | 创建可空属性访问Lambda表达式, 调用Compile()后即可使用 |
| AccessProperty | 生成非空属性访问链表达式, 需要串联ToXXX方法创建最终表达式 |
| AccessNullableProperty | 生成可空属性访问链表达式，需要串联ToXXX方法创建最终表达式 |
| AccessPropertyDefaultIfNull | 生成DefaultIfNull属性表达式，当属性访问结果是null时，使用传入的默认值，需要串联ToXXX方法创建最终表达式 |
| ToDelegate | 从AccessXXX方法创建委托方法 |
| ToLambdaExpression | 从AccessXXX方法创建Lambda表达式 |
| ToFuncExpression | 从AccessXXX方法创建Func<,>委托方法 |