API Host ScriptJsonSerializer

ScriptJsonSerializer

脚本值与 JSON 之间转换的基础序列化器。

Base serializer for script values to/from JSON.

命名空间：AuroraScript.Runtime.Serialization。类型：class。

Namespace: AuroraScript.Runtime.Serialization. Kind: class.

返回 .NET Host API 参考

Back to .NET Host API Reference

用途

Purpose

ScriptJsonSerializer 是公开宿主类型。通过下方签名选择调用方式；对运行时对象、生命周期和异常，应由宿主在边界处明确处理。

Base serializer for script values to/from JSON.

简单示例

Simple Example

下面是 ScriptJsonSerializer 的最小使用方式。

A minimal use of ScriptJsonSerializer.

var serializer = ScriptJsonSerializer.Default;

var json = serializer.Serialize(ScriptDatum.FromNumber(42));
var value = serializer.Deserialize("{\"name\":\"Aurora\"}");

Console.WriteLine(json); // 42

成员

Members

static readonly ScriptJsonSerializer Default

读取 Default 字段。

Use the member according to its public signature.

Parameters:

• 无。

  None.

Returns

返回 ScriptJsonSerializer。

Returns ScriptJsonSerializer.

调用示意

以下示例展示调用形状；将占位实例和参数替换为宿主中的实际值。

The example shows the call shape; replace placeholder instances and arguments with actual host values.

var current = ScriptJsonSerializer.Default;

string Serialize(ScriptDatum datum, EngineOptions options = null, bool indented = false)

调用 Serialize 完成其公开操作。

Use the member according to its public signature.

Parameters:

• datum
  要读取或写入的脚本值。

  Script value to read or write.

• options
  控制此操作的配置。

  Configuration controlling this operation.

• indented
  是否生成带缩进的 JSON。

  Whether to generate indented JSON.

Returns

返回 string。

Returns string.

调用示意

以下示例展示调用形状；将占位实例和参数替换为宿主中的实际值。

The example shows the call shape; replace placeholder instances and arguments with actual host values.

ScriptJsonSerializer value = /* 从宿主 API 获取实例 */;
var result = value.Serialize(/* datum */, /* options */, /* indented */);

ScriptObject Deserialize(string jsonText, EngineOptions options = null)

调用 Deserialize 完成其公开操作。

Use the member according to its public signature.

Parameters:

• jsonText
  要序列化或反序列化的 JSON 文本。

  JSON text to serialize or deserialize.

• options
  控制此操作的配置。

  Configuration controlling this operation.

Returns

返回 ScriptObject。

Returns ScriptObject.

调用示意

以下示例展示调用形状；将占位实例和参数替换为宿主中的实际值。

The example shows the call shape; replace placeholder instances and arguments with actual host values.

ScriptJsonSerializer value = /* 从宿主 API 获取实例 */;
var result = value.Deserialize(/* jsonText */, /* options */);