JsonNode.Parse 方法

定义

命名空间:

System.Text.Json.Nodes

程序集:

System.Text.Json.dll

包:

System.Text.Json v9.0.0-preview.3.24172.9

重载

Parse(String, Nullable<JsonNodeOptions>, JsonDocumentOptions)	分析表示单个 JSON 值的文本。
Parse(ReadOnlySpan<Byte>, Nullable<JsonNodeOptions>, JsonDocumentOptions)	分析表示单个 JSON 值的文本。
Parse(Utf8JsonReader, Nullable<JsonNodeOptions>)	通过提供的读取器分析一个 JSON 值（包括对象或数组）。
Parse(Stream, Nullable<JsonNodeOptions>, JsonDocumentOptions)	将 Stream 作为 UTF-8 编码的数据（表示单个 JSON 值）分析为 JsonNode。 Stream将读取到完成。

Parse(String, Nullable<JsonNodeOptions>, JsonDocumentOptions)

Source:

JsonNode.Parse.cs

分析表示单个 JSON 值的文本。

public static System.Text.Json.Nodes.JsonNode? Parse (string json, System.Text.Json.Nodes.JsonNodeOptions? nodeOptions = default, System.Text.Json.JsonDocumentOptions documentOptions = default);

static member Parse : string * Nullable<System.Text.Json.Nodes.JsonNodeOptions> * System.Text.Json.JsonDocumentOptions -> System.Text.Json.Nodes.JsonNode

Public Shared Function Parse (json As String, Optional nodeOptions As Nullable(Of JsonNodeOptions) = Nothing, Optional documentOptions As JsonDocumentOptions = Nothing) As JsonNode

参数

json

String

要分析的 JSON 文本。

nodeOptions

Nullable<JsonNodeOptions>

用于控制分析后节点行为的选项。

documentOptions

JsonDocumentOptions

用于在分析期间控制文档行为的选项。

返回

JsonNode

JsonNode JSON 值的表示形式;如果输入表示 NULL JSON 值，则为 null。

例外

ArgumentNullException

json 为 null。

JsonException

json 不表示有效的单个 JSON 值。

Parse(ReadOnlySpan<Byte>, Nullable<JsonNodeOptions>, JsonDocumentOptions)

Source:

JsonNode.Parse.cs

分析表示单个 JSON 值的文本。

public static System.Text.Json.Nodes.JsonNode? Parse (ReadOnlySpan<byte> utf8Json, System.Text.Json.Nodes.JsonNodeOptions? nodeOptions = default, System.Text.Json.JsonDocumentOptions documentOptions = default);

static member Parse : ReadOnlySpan<byte> * Nullable<System.Text.Json.Nodes.JsonNodeOptions> * System.Text.Json.JsonDocumentOptions -> System.Text.Json.Nodes.JsonNode

Public Shared Function Parse (utf8Json As ReadOnlySpan(Of Byte), Optional nodeOptions As Nullable(Of JsonNodeOptions) = Nothing, Optional documentOptions As JsonDocumentOptions = Nothing) As JsonNode

参数

utf8Json

ReadOnlySpan<Byte>

要分析的 JSON 文本。

nodeOptions

Nullable<JsonNodeOptions>

用于控制分析后节点行为的选项。

documentOptions

JsonDocumentOptions

用于在分析期间控制文档行为的选项。

返回

JsonNode

JsonNode JSON 值的表示形式;如果输入表示 NULL JSON 值，则为 null。

例外

JsonException

utf8Json 不表示有效的单个 JSON 值。

Parse(Utf8JsonReader, Nullable<JsonNodeOptions>)

Source:

JsonNode.Parse.cs

通过提供的读取器分析一个 JSON 值（包括对象或数组）。

public static System.Text.Json.Nodes.JsonNode? Parse (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.Nodes.JsonNodeOptions? nodeOptions = default);

static member Parse : Utf8JsonReader * Nullable<System.Text.Json.Nodes.JsonNodeOptions> -> System.Text.Json.Nodes.JsonNode

Public Shared Function Parse (ByRef reader As Utf8JsonReader, Optional nodeOptions As Nullable(Of JsonNodeOptions) = Nothing) As JsonNode

参数

reader

Utf8JsonReader

要用于读取的读取器。

nodeOptions

Nullable<JsonNodeOptions>

用于控制行为的选项。

返回

JsonNode

JsonNode来自读取器的 ;如果输入表示空 JSON 值，则为 null。

例外

ArgumentException

reader 使用的是不受支持的选项。

ArgumentException

当前 reader 令牌不启动或表示值。

JsonException

无法从读取器中读取值。

注解

TokenType如果 的 reader 属性为 PropertyName 或 None，则读取器将通过对 的一次调用Read()来提前确定值的开头。

此方法完成后， reader 位于 JSON 值中的最终标记处。 如果引发异常，读取器将重置为调用 方法时处于的状态。

此方法创建读取器操作的数据的副本，因此除了此方法的返回之外，调用方不需要维护数据完整性。

Parse(Stream, Nullable<JsonNodeOptions>, JsonDocumentOptions)

Source:

JsonNode.Parse.cs

将 Stream 作为 UTF-8 编码的数据（表示单个 JSON 值）分析为 JsonNode。 Stream将读取到完成。

public static System.Text.Json.Nodes.JsonNode? Parse (System.IO.Stream utf8Json, System.Text.Json.Nodes.JsonNodeOptions? nodeOptions = default, System.Text.Json.JsonDocumentOptions documentOptions = default);

static member Parse : System.IO.Stream * Nullable<System.Text.Json.Nodes.JsonNodeOptions> * System.Text.Json.JsonDocumentOptions -> System.Text.Json.Nodes.JsonNode

Public Shared Function Parse (utf8Json As Stream, Optional nodeOptions As Nullable(Of JsonNodeOptions) = Nothing, Optional documentOptions As JsonDocumentOptions = Nothing) As JsonNode

参数

utf8Json

Stream

要分析的 JSON 文本。

nodeOptions

Nullable<JsonNodeOptions>

用于控制分析后节点行为的选项。

documentOptions

JsonDocumentOptions

用于在分析期间控制文档行为的选项。

返回

JsonNode

JsonNode JSON 值的表示形式;如果输入表示 NULL JSON 值，则为 null。

例外

JsonException

utf8Json 不表示有效的单个 JSON 值。