https://github.com/cuture/cuture.extensions.systemtextjson.dynamic
Extension of `System.Text.Json` to support dynamic access using `dynamic`; 对 `System.Text.Json` 的拓展，以支持使用 `dynamic` 进行动态访问
https://github.com/cuture/cuture.extensions.systemtextjson.dynamic
dotnet dynamic dynamic-json dynamic-system-text-json json system-text-json
Last synced: 6 months ago
JSON representation
Extension of `System.Text.Json` to support dynamic access using `dynamic`; 对 `System.Text.Json` 的拓展，以支持使用 `dynamic` 进行动态访问
- Host: GitHub
- URL: https://github.com/cuture/cuture.extensions.systemtextjson.dynamic
- Owner: cuture
- License: mit
- Created: 2023-02-11T06:53:06.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2025-08-10T02:46:02.000Z (11 months ago)
- Last Synced: 2025-09-17T22:50:12.500Z (10 months ago)
- Topics: dotnet, dynamic, dynamic-json, dynamic-system-text-json, json, system-text-json
- Language: C#
- Homepage:
- Size: 44.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Cuture.Extensions.SystemTextJson.Dynamic
Extension of `System.Text.Json` to support dynamic access using `dynamic`
对 `System.Text.Json` 的拓展，以支持使用 `dynamic` 进行动态访问
- 使用 `dynamic` 访问，无需预定义实体类型
- 支持修改/添加属性
## 创建 `JSON` 对象
### 从 `Json字符串` 创建 `JSON` 对象
```C#
using System.Text.Json.Dynamic;
var rawJson =
"""
{
"a":1,
"b":2.0,
"c":{
"a":"1",
"b":"2",
},
}
""";
var json = JSON.parse(rawJson);
```
### 从 `对象` 创建 `JSON` 对象
```C#
using System.Text.Json.Dynamic;
var json = JSON.create(new object());
```
## 访问 `JSON` 对象
```C#
//访问属性
var a = json.a;
var c = json.a.b.c;
//访问数组
var v2 = json.x[1];
var v3 = json.x.last();
var v4 = json.x.first();
var v5 = json.x.push(obj);
var v6 = json.x.pop();
var v7 = json.x.add(obj);
var v8 = json.x.append(obj);
var v9 = json.x.insert(1,obj);
var va = json.x.RemoveAt(1);
json.x.clear();
//访问属性并转换为基础数据类型
bool b1 = json.b;
string s1 = json.s;
//局部反序列化
MyClass obj = json.a.b; //将 json.a.b 反序列化到类型 MyClass
//获取内部的原始 System.Text.Json.Nodes.* 对象
JsonArray array = json.ArrayProperty;
JsonObject obj = json.ObjectProperty;
JsonNode node = json.NodeProperty;
```
## 修改 `JSON` 对象
```C#
//设置值（不可多级设置未定义字段）
json.a = new {};
json.a.b = 1;
json.c = new
{
d = new
{
e = 2
}
};
int value = json.a.b;
```
## 检查 `JSON` 对象
```C#
//判断是否为未定义字段
var b1 = json.notexistfield == null;
var b2 = json.notexistfield == JSON.Undefined;
var b3 = JSON.isUndefined(json.notexistfield);
//多级属性判断是否为未定义字段
var b4 = JSON.isUndefined(() => json.a.b.c.e.f.g.h.i.j.k);
```
## IEnumerable
使用`IEnumerable`以支持使用Linq, (C#不支持实现dynamic的接口，所以需要额外的转换)
```C#
//遍历Array
//显式赋值类型
IEnumerable enumerable = json.Array;
//通过IDynamicEnumerable
var enumerable = ((IDynamicEnumerable)json.Array).AsEnumerable();
//遍历属性
//显式赋值类型
IEnumerable> enumerable = json;
//通过IDynamicKeyValueEnumerable
var enumerable = ((IDynamicKeyValueEnumerable)json).AsEnumerable();
```
## Index && Range
支持使用 Index 和 Range 语法访问数组
Note: 当前使用 Range 语法将会创建新的对象，对其修改不会反映到原始对象
```C#
//Index
var value = json.Array[^1];
//Range
var items = json.Array[..1];
```