mirror of
https://gitee.com/ant-design-blazor/ant-design-blazor.git
synced 2024-12-16 01:41:14 +08:00
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>
60 lines
3.9 KiB
Markdown
60 lines
3.9 KiB
Markdown
---
|
||
order: 5
|
||
title: 路径式属性访问
|
||
---
|
||
|
||
提供 `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. 非空模式
|
||
|
||
<span style="font-weight: bold;">⚠注意：非空模式下需要开发者保证属性路径上的属性不为null，如果包含数组模式或字典模式，还需要保证索引对象必须存在，否则访问不存在的对象的属性时会抛出异常。</span>
|
||
|
||
当结果数据类型是值类型且不是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. 可空模式
|
||
|
||
<span style="font-weight: bold;">可空模式下不需要保证数据不为null，也不用保证数组模式或字典模式必定有值，访问到不存在对象的属性时会返回null。</span>
|
||
|
||
当结果数据类型是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<,>委托方法 |
|