JsonSerializer.Deserialize 方法

定义

命名空间:

System.Text.Json

程序集:

System.Text.Json.dll

重载

Deserialize(Stream, JsonTypeInfo)	将表示单个 JSON 值的 UTF-8 编码文本读入由 jsonTypeInfo指定的实例。 流将读取到完成。
Deserialize(Utf8JsonReader, Type, JsonSerializerContext)	将提供的读取器中的一个 JSON 值（包括对象或数组）读入 returnType。
Deserialize(JsonNode, Type, JsonSerializerContext)	将表示单个 JSON 值的 JsonNode 转换为 returnType。
Deserialize(JsonNode, Type, JsonSerializerOptions)	将表示单个 JSON 值的 JsonNode 转换为 returnType。
Deserialize(JsonElement, Type, JsonSerializerContext)	将表示单个 JSON 值的 JsonElement 转换为 returnType。
Deserialize(JsonElement, Type, JsonSerializerOptions)	将表示单个 JSON 值的 JsonElement 转换为 returnType。
Deserialize(JsonDocument, Type, JsonSerializerContext)	将表示单个 JSON 值的 JsonDocument 转换为 returnType。
Deserialize(JsonDocument, Type, JsonSerializerOptions)	将表示单个 JSON 值的 JsonDocument 转换为 returnType。
Deserialize(String, Type, JsonSerializerContext)	将表示单个 JSON 值的文本分析为 returnType。
Deserialize(String, Type, JsonSerializerOptions)	将表示单个 JSON 值的文本分析为指定类型的实例。
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)	将表示单个 JSON 值的文本分析为 returnType。
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)	将表示单个 JSON 值的文本分析为指定类型的实例。
Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)	从提供的读取器读取一个 JSON 值（包括对象或数组），并将其转换为指定类型的实例。
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)	将表示单个 JSON 值的 UTF-8 编码文本分析为指定类型的实例。
Deserialize(Stream, Type, JsonSerializerContext)	将表示单个 JSON 值的 UTF-8 编码文本读入 returnType。 流将读取到完成。
Deserialize(Stream, Type, JsonSerializerOptions)	将表示单个 JSON 值的 UTF-8 编码文本读入 returnType。 流将读取到完成。
Deserialize(Utf8JsonReader, JsonTypeInfo)	将提供的读取器中的一个 JSON 值（包括对象或数组）读取到由 jsonTypeInfo指定的实例中。
Deserialize(JsonNode, JsonTypeInfo)	将表示单个 JSON 值的 JsonNode 转换为由 jsonTypeInfo指定的实例。
Deserialize(JsonElement, JsonTypeInfo)	将表示单个 JSON 值的 JsonElement 转换为由 jsonTypeInfo指定的实例。
Deserialize(JsonDocument, JsonTypeInfo)	将表示单个 JSON 值的 JsonDocument 转换为由 jsonTypeInfo指定的实例。
Deserialize(String, JsonTypeInfo)	将表示单个 JSON 值的文本分析为由 jsonTypeInfo指定的实例。
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)	将表示单个 JSON 值的文本分析为由 jsonTypeInfo指定的实例。
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)	将表示单个 JSON 值的 UTF-8 编码文本分析为 returnType。
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)	将表示单个 JSON 值的 UTF-8 编码文本分析为由 jsonTypeInfo指定的实例。
Deserialize<TValue>(JsonElement, JsonSerializerOptions)	将表示单个 JSON 值的 JsonElement 转换为 TValue。
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)	将表示单个 JSON 值的 JsonElement 转换为 TValue。
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)	将提供的读取器中的一个 JSON 值（包括对象或数组）读入 TValue。
Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>)	将表示单个 JSON 值的 JsonNode 转换为 TValue。
Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)	将提供的读取器中的一个 JSON 值（包括对象或数组）读取到泛型类型参数指定的类型的实例中。
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)	将表示单个 JSON 值的 JsonDocument 转换为 TValue。
Deserialize<TValue>(JsonNode, JsonSerializerOptions)	将表示单个 JSON 值的 JsonNode 转换为 TValue。
Deserialize<TValue>(JsonDocument, JsonSerializerOptions)	将表示单个 JSON 值的 JsonDocument 转换为 TValue。
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)	将表示单个 JSON 值的文本分析为 TValue。
Deserialize<TValue>(String, JsonSerializerOptions)	将表示单个 JSON 值的文本分析为泛型类型参数指定的类型的实例。
Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)	将表示单个 JSON 值的文本分析为泛型类型参数指定的类型的实例。
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)	将表示单个 JSON 值的 UTF-8 编码文本分析为 TValue。
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)	将表示单个 JSON 值的 UTF-8 编码文本分析为泛型类型参数指定的类型的实例。
Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)	将表示单个 JSON 值的 UTF-8 编码文本读入 TValue。 流将读取到完成。
Deserialize<TValue>(Stream, JsonSerializerOptions)	将表示单个 JSON 值的 UTF-8 编码文本读入 TValue。 流将读取到完成。
Deserialize<TValue>(String, JsonTypeInfo<TValue>)	将表示单个 JSON 值的文本分析为 TValue。

Deserialize(Stream, JsonTypeInfo)

Source:

JsonSerializer.Read.Stream.cs

将表示单个 JSON 值的 UTF-8 编码文本读入由 jsonTypeInfo指定的实例。 流将读取到完成。

public:
 static System::Object ^ Deserialize(System::IO::Stream ^ utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

Public Function Deserialize (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo) As Object

参数

utf8Json

Stream

要分析的 JSON 数据。

jsonTypeInfo

JsonTypeInfo

要转换的类型的元数据。

返回

Object

JSON 值的 jsonTypeInfo 表示形式。

例外

ArgumentNullException

utf8Json 或 jsonTypeInfonull。

JsonException

JSON 无效，或者 Stream 中有剩余数据。

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.Utf8JsonReader.cs

将提供的读取器中的一个 JSON 值（包括对象或数组）读入 returnType。

public:
 static System::Object ^ Deserialize(System::Text::Json::Utf8JsonReader % reader, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : Utf8JsonReader * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, context As JsonSerializerContext) As Object

参数

reader

Utf8JsonReader

要读取的读取器。

returnType

Type

要转换为和返回的对象的类型。

context

JsonSerializerContext

可序列化类型的元数据提供程序。

返回

Object

JSON 值的 returnType 表示形式。

例外

ArgumentNullException

returnType 或 contextnull。

JsonException

JSON 无效，returnType 与 JSON 不兼容，或者无法从读取器读取值。

ArgumentException

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

NotSupportedException

returnType 或其可序列化成员没有兼容的 JsonConverter。

InvalidOperationException

提供的 context 上的 GetTypeInfo(Type) 方法未返回 returnType的兼容 JsonTypeInfo。

注解

如果 PropertyName 或 Nonereader 的 TokenType 属性，则读取器将通过一次调用 Read() 来确定值的开始。

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

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

用于创建 Utf8JsonReader 实例的 JsonReaderOptions 在冲突时优先于 JsonSerializerOptions。 因此，读取时使用 AllowTrailingCommas、MaxDepth和 CommentHandling。

Deserialize(JsonNode, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.Node.cs

将表示单个 JSON 值的 JsonNode 转换为 returnType。

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::Nodes::JsonNode ^ node, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : System.Text.Json.Nodes.JsonNode * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

<Extension()>
Public Function Deserialize (node As JsonNode, returnType As Type, context As JsonSerializerContext) As Object

参数

node

JsonNode

要转换的 JsonNode。

returnType

Type

要转换为和返回的对象的类型。

context

JsonSerializerContext

可序列化类型的元数据提供程序。

返回

Object

JSON 值的 returnType 表示形式。

例外

ArgumentNullException

returnType null。

-或-

context null。

JsonException

JSON 无效。

-或-

returnType 与 JSON 不兼容。

-或-

字符串中存在超出单个 JSON 值的剩余数据。

NotSupportedException

returnType 或其可序列化成员没有兼容的 JsonConverter。

InvalidOperationException

提供的 contextGetTypeInfo(Type) 方法返回要转换的类型 null。

Deserialize(JsonNode, Type, JsonSerializerOptions)

Source:

JsonSerializer.Read.Node.cs

将表示单个 JSON 值的 JsonNode 转换为 returnType。

public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.Nodes.JsonNode * Type * System.Text.Json.JsonSerializerOptions -> obj

<Extension()>
Public Function Deserialize (node As JsonNode, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

参数

node

JsonNode

要转换的 JsonNode。

returnType

Type

要转换为和返回的对象的类型。

options

JsonSerializerOptions

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

返回

Object

JSON 值的 returnType 表示形式。

例外

JsonException

returnType 与 JSON 不兼容。

NotSupportedException

returnType 或其可序列化成员没有兼容的 JsonConverter。

Deserialize(JsonElement, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.Element.cs

将表示单个 JSON 值的 JsonElement 转换为 returnType。

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::JsonElement element, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (this System.Text.Json.JsonElement element, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : System.Text.Json.JsonElement * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

<Extension()>
Public Function Deserialize (element As JsonElement, returnType As Type, context As JsonSerializerContext) As Object

参数

element

JsonElement

要转换的 JsonElement。

returnType

Type

要转换为和返回的对象的类型。

context

JsonSerializerContext

可序列化类型的元数据提供程序。

返回

Object

JSON 值的 returnType 表示形式。

例外

ArgumentNullException

returnType null。

-或-

context null。

JsonException

JSON 无效。

-或-

returnType 与 JSON 不兼容。

-或-

字符串中存在超出单个 JSON 值的剩余数据。

NotSupportedException

returnType 或其可序列化成员没有兼容的 JsonConverter。

InvalidOperationException

提供的 contextGetTypeInfo(Type) 方法返回要转换的类型 null。

Deserialize(JsonElement, Type, JsonSerializerOptions)

Source:

JsonSerializer.Read.Element.cs

将表示单个 JSON 值的 JsonElement 转换为 returnType。

public static object? Deserialize (this System.Text.Json.JsonElement element, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.JsonElement * Type * System.Text.Json.JsonSerializerOptions -> obj

<Extension()>
Public Function Deserialize (element As JsonElement, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

参数

element

JsonElement

要转换的 JsonElement。

returnType

Type

要转换为和返回的对象的类型。

options

JsonSerializerOptions

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

返回

Object

JSON 值的 returnType 表示形式。

例外

ArgumentNullException

returnType null。

JsonException

returnType 与 JSON 不兼容。

NotSupportedException

returnType 或其可序列化成员没有兼容的 JsonConverter。

Deserialize(JsonDocument, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.Document.cs

将表示单个 JSON 值的 JsonDocument 转换为 returnType。

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::JsonDocument ^ document, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (this System.Text.Json.JsonDocument document, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : System.Text.Json.JsonDocument * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

<Extension()>
Public Function Deserialize (document As JsonDocument, returnType As Type, context As JsonSerializerContext) As Object

参数

document

JsonDocument

要转换的 JsonDocument。

returnType

Type

要转换为和返回的对象的类型。

context

JsonSerializerContext

可序列化类型的元数据提供程序。

返回

Object

JSON 值的 returnType 表示形式。

例外

ArgumentNullException

document null。

-或-

returnType null。

-或-

context null。

JsonException

JSON 无效。

-或-

returnType 与 JSON 不兼容。

-或-

字符串中存在超出单个 JSON 值的剩余数据。

NotSupportedException

returnType 或其可序列化成员没有兼容的 JsonConverter。

InvalidOperationException

提供的 contextGetTypeInfo(Type) 方法返回要转换的类型 null。

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Source:

JsonSerializer.Read.Document.cs

将表示单个 JSON 值的 JsonDocument 转换为 returnType。

public static object? Deserialize (this System.Text.Json.JsonDocument document, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.JsonDocument * Type * System.Text.Json.JsonSerializerOptions -> obj

<Extension()>
Public Function Deserialize (document As JsonDocument, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

参数

document

JsonDocument

要转换的 JsonDocument。

returnType

Type

要转换为和返回的对象的类型。

options

JsonSerializerOptions

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

返回

Object

JSON 值的 returnType 表示形式。

例外

ArgumentNullException

document 或 returnTypenull。

JsonException

returnType 与 JSON 不兼容。

NotSupportedException

returnType 或其可序列化成员没有兼容的 JsonConverter。

Deserialize(String, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.String.cs

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

public:
 static System::Object ^ Deserialize(System::String ^ json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (string json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : string * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (json As String, returnType As Type, context As JsonSerializerContext) As Object

参数

json

String

要分析的 JSON 文本。

returnType

Type

要转换为和返回的对象的类型。

context

JsonSerializerContext

可序列化类型的元数据提供程序。

返回

Object

JSON 值的 returnType 表示形式。

例外

ArgumentNullException

json 或 returnTypenull。

-或-

context null。

JsonException

JSON 无效。

-或-

returnType 与 JSON 不兼容。

-或-

字符串中存在超出单个 JSON 值的剩余数据。

NotSupportedException

returnType 或其可序列化成员没有兼容的 JsonConverter。

InvalidOperationException

提供的 contextGetTypeInfo(Type) 方法返回要转换的类型 null。

注解

使用 String 不像使用 UTF-8 方法那么高效，因为实现本机使用 UTF-8。

Deserialize(String, Type, JsonSerializerOptions)

Source:

JsonSerializer.Read.String.cs

将表示单个 JSON 值的文本分析为指定类型的实例。

public static object? Deserialize (string json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : string * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

参数

json

String

要分析的 JSON 文本。

returnType

Type

要转换为和返回的对象的类型。

options

JsonSerializerOptions

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

返回

Object

JSON 值的 returnType 表示形式。

例外

ArgumentNullException

json 或 returnTypenull。

JsonException

JSON 无效。

-或-

TValue 与 JSON 不兼容。

-或-

字符串中存在超出单个 JSON 值的剩余数据。

NotSupportedException

returnType 或其可序列化成员没有兼容的 JsonConverter。

注解

使用 String 不像使用 UTF-8 方法那么高效，因为实现本机使用 UTF-8。

有关详细信息，请参阅 如何序列化和反序列化 JSON。

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.String.cs

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

public:
 static System::Object ^ Deserialize(ReadOnlySpan<char> json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (ReadOnlySpan<char> json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, context As JsonSerializerContext) As Object

参数

json

ReadOnlySpan<Char>

要分析的 JSON 文本。

returnType

Type

要转换为和返回的对象的类型。

context

JsonSerializerContext

可序列化类型的元数据提供程序。

返回

Object

JSON 值的 returnType 表示形式。

例外

ArgumentNullException

json 或 returnTypenull。

-或-

context null。

JsonException

JSON 无效。

-或-

returnType 与 JSON 不兼容。

-或-

字符串中存在超出单个 JSON 值的剩余数据。

NotSupportedException

returnType 或其可序列化成员没有兼容的 JsonConverter。

InvalidOperationException

提供的 contextGetTypeInfo(Type) 方法返回要转换的类型 null。

注解

使用 String 不像使用 UTF-8 方法那么高效，因为实现本机使用 UTF-8。

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

Source:

JsonSerializer.Read.String.cs

将表示单个 JSON 值的文本分析为指定类型的实例。

public static object? Deserialize (ReadOnlySpan<char> json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : ReadOnlySpan<char> * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Function Deserialize (json As ReadOnlySpan(Of Char), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

参数

json

ReadOnlySpan<Char>

要分析的 JSON 文本。

returnType

Type

要转换为和返回的对象的类型。

options

JsonSerializerOptions

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

返回

Object

JSON 值的 returnType 表示形式。

例外

ArgumentNullException

returnType null。

JsonException

JSON 无效。

-或-

returnType 与 JSON 不兼容。

-或-

跨度中存在超出单个 JSON 值的剩余数据。

NotSupportedException

returnType 或其可序列化成员没有兼容的 JsonConverter。

注解

使用 UTF-16 范围不像使用 UTF-8 方法那样高效，因为实现本机使用 UTF-8。

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

Source:

JsonSerializer.Read.Utf8JsonReader.cs

从提供的读取器读取一个 JSON 值（包括对象或数组），并将其转换为指定类型的实例。

public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : Utf8JsonReader * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

参数

reader

Utf8JsonReader

要从中读取 JSON 的读取器。

returnType

Type

要转换为和返回的对象的类型。

options

JsonSerializerOptions

用于在读取期间控制序列化程序行为的选项。

返回

Object

JSON 值的 returnType 表示形式。

例外

ArgumentNullException

returnType null。

JsonException

JSON 无效。

-或-

returnType 与 JSON 不兼容。

-或-

无法从读取器读取值。

ArgumentException

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

NotSupportedException

returnType 或其可序列化成员没有兼容的 JsonConverter。

注解

如果 JsonTokenType.PropertyName 或 JsonTokenType.Nonereader 的 TokenType 属性，则读取器将通过一次调用 Utf8JsonReader.Read() 来确定值的开始。

完成此方法后，reader 将放置在 JSON 值中的最终令牌上。 如果引发异常，则读取器将重置为调用该方法时处于的状态。

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

用于创建 Utf8JsonReader 实例的 JsonReaderOptions 在冲突时优先于 JsonSerializerOptions。 因此，读取时使用 JsonReaderOptions.AllowTrailingCommas、JsonReaderOptions.MaxDepth和 JsonReaderOptions.CommentHandling。

有关详细信息，请参阅 如何序列化和反序列化 JSON。

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

Source:

JsonSerializer.Read.Span.cs

将表示单个 JSON 值的 UTF-8 编码文本分析为指定类型的实例。

public static object? Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

参数

utf8Json

ReadOnlySpan<Byte>

要分析的 JSON 文本。

returnType

Type

要转换为和返回的对象的类型。

options

JsonSerializerOptions

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

返回

Object

JSON 值的 returnType 表示形式。

例外

ArgumentNullException

returnType null。

JsonException

JSON 无效。

-或-

returnType 与 JSON 不兼容。

-或-

跨度中存在超出单个 JSON 值的剩余数据。

NotSupportedException

returnType 或其可序列化成员没有兼容的 JsonConverter。

注解

有关详细信息，请参阅 如何序列化和反序列化 JSON。

Deserialize(Stream, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.Stream.cs

将表示单个 JSON 值的 UTF-8 编码文本读入 returnType。 流将读取到完成。

public:
 static System::Object ^ Deserialize(System::IO::Stream ^ utf8Json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (System.IO.Stream utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : System.IO.Stream * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (utf8Json As Stream, returnType As Type, context As JsonSerializerContext) As Object

参数

utf8Json

Stream

要分析的 JSON 数据。

returnType

Type

要转换为和返回的对象的类型。

context

JsonSerializerContext

可序列化类型的元数据提供程序。

返回

Object

JSON 值的 returnType 表示形式。

例外

ArgumentNullException

utf8Json、returnType或 contextnull。

JsonException

JSON 无效，returnType 与 JSON 不兼容，或者 Stream 中有剩余数据。

NotSupportedException

returnType 或其可序列化成员没有兼容的 JsonConverter。

InvalidOperationException

提供的 context 上的 GetTypeInfo(Type) 方法未返回 returnType的兼容 JsonTypeInfo。

Deserialize(Stream, Type, JsonSerializerOptions)

Source:

JsonSerializer.Read.Stream.cs

将表示单个 JSON 值的 UTF-8 编码文本读入 returnType。 流将读取到完成。

public static object? Deserialize (System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions -> obj

Public Function Deserialize (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

参数

utf8Json

Stream

要分析的 JSON 数据。

returnType

Type

要转换为和返回的对象的类型。

options

JsonSerializerOptions

用于控制读取过程中行为的选项。

返回

Object

JSON 值的 returnType 表示形式。

例外

ArgumentNullException

utf8Json 或 returnTypenull。

JsonException

JSON 无效，returnType 与 JSON 不兼容，或者 Stream 中有剩余数据。

NotSupportedException

returnType 或其可序列化成员没有兼容的 JsonConverter。

Deserialize(Utf8JsonReader, JsonTypeInfo)

Source:

JsonSerializer.Read.Utf8JsonReader.cs

将提供的读取器中的一个 JSON 值（包括对象或数组）读取到由 jsonTypeInfo指定的实例中。

public:
 static System::Object ^ Deserialize(System::Text::Json::Utf8JsonReader % reader, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : Utf8JsonReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

Public Function Deserialize (ByRef reader As Utf8JsonReader, jsonTypeInfo As JsonTypeInfo) As Object

参数

reader

Utf8JsonReader

要读取的读取器。

jsonTypeInfo

JsonTypeInfo

要转换的类型的元数据。

返回

Object

JSON 值的 jsonTypeInfo 表示形式。

例外

JsonException

JSON 无效，jsonTypeInfo 与 JSON 不兼容，或者无法从读取器读取值。

ArgumentException

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

注解

如果 PropertyName 或 Nonereader 的 TokenType 属性，则读取器将通过一次调用 Read() 来确定值的开始。

完成此方法后，reader 将放置在 JSON 值中的最终令牌上。 如果引发异常，则读取器将重置为调用该方法时处于的状态。

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

用于创建 Utf8JsonReader 实例的 JsonReaderOptions 在冲突时优先于 JsonSerializerOptions。 因此，读取时使用 AllowTrailingCommas、MaxDepth和 CommentHandling。

Deserialize(JsonNode, JsonTypeInfo)

Source:

JsonSerializer.Read.Node.cs

将表示单个 JSON 值的 JsonNode 转换为由 jsonTypeInfo指定的实例。

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::Nodes::JsonNode ^ node, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

<Extension()>
Public Function Deserialize (node As JsonNode, jsonTypeInfo As JsonTypeInfo) As Object

参数

node

JsonNode

要转换的 JsonNode。

jsonTypeInfo

JsonTypeInfo

要转换的类型的元数据。

返回

Object

JSON 值的 jsonTypeInfo 表示形式。

例外

ArgumentNullException

jsonTypeInfo null。

Deserialize(JsonElement, JsonTypeInfo)

Source:

JsonSerializer.Read.Element.cs

将表示单个 JSON 值的 JsonElement 转换为由 jsonTypeInfo指定的实例。

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::JsonElement element, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (this System.Text.Json.JsonElement element, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

<Extension()>
Public Function Deserialize (element As JsonElement, jsonTypeInfo As JsonTypeInfo) As Object

参数

element

JsonElement

要转换的 JsonElement。

jsonTypeInfo

JsonTypeInfo

要转换的类型的元数据。

返回

Object

JSON 值的 jsonTypeInfo 表示形式。

例外

ArgumentNullException

jsonTypeInfo null。

Deserialize(JsonDocument, JsonTypeInfo)

Source:

JsonSerializer.Read.Document.cs

将表示单个 JSON 值的 JsonDocument 转换为由 jsonTypeInfo指定的实例。

public:
[System::Runtime::CompilerServices::Extension]
 static System::Object ^ Deserialize(System::Text::Json::JsonDocument ^ document, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (this System.Text.Json.JsonDocument document, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

<Extension()>
Public Function Deserialize (document As JsonDocument, jsonTypeInfo As JsonTypeInfo) As Object

参数

document

JsonDocument

要转换的 JsonDocument。

jsonTypeInfo

JsonTypeInfo

要转换的类型的元数据。

返回

Object

JSON 值的 jsonTypeInfo 表示形式。

例外

ArgumentNullException

document null。

-或-

jsonTypeInfo null。

Deserialize(String, JsonTypeInfo)

Source:

JsonSerializer.Read.String.cs

将表示单个 JSON 值的文本分析为由 jsonTypeInfo指定的实例。

public:
 static System::Object ^ Deserialize(System::String ^ json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (string json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : string * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

Public Function Deserialize (json As String, jsonTypeInfo As JsonTypeInfo) As Object

参数

json

String

要分析的 JSON 文本。

jsonTypeInfo

JsonTypeInfo

要转换的类型的元数据。

返回

Object

JSON 值的 jsonTypeInfo 表示形式。

例外

ArgumentNullException

json null。

-或-

jsonTypeInfo null。

JsonException

JSON 无效。

-或-

字符串中存在超出单个 JSON 值的剩余数据。

注解

使用 String 不像使用 UTF-8 方法那么高效，因为实现本机使用 UTF-8。

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

Source:

JsonSerializer.Read.String.cs

将表示单个 JSON 值的文本分析为由 jsonTypeInfo指定的实例。

public:
 static System::Object ^ Deserialize(ReadOnlySpan<char> json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (ReadOnlySpan<char> json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : ReadOnlySpan<char> * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

Public Function Deserialize (json As ReadOnlySpan(Of Char), jsonTypeInfo As JsonTypeInfo) As Object

参数

json

ReadOnlySpan<Char>

要分析的 JSON 文本。

jsonTypeInfo

JsonTypeInfo

要转换的类型的元数据。

返回

Object

JSON 值的 jsonTypeInfo 表示形式。

例外

ArgumentNullException

jsonTypeInfo null。

JsonException

JSON 无效。

-或-

字符串中存在超出单个 JSON 值的剩余数据。

注解

使用 String 不像使用 UTF-8 方法那么高效，因为实现本机使用 UTF-8。

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

Source:

JsonSerializer.Read.Span.cs

将表示单个 JSON 值的 UTF-8 编码文本分析为 returnType。

public:
 static System::Object ^ Deserialize(ReadOnlySpan<System::Byte> utf8Json, Type ^ returnType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static object? Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context);

static member Deserialize : ReadOnlySpan<byte> * Type * System.Text.Json.Serialization.JsonSerializerContext -> obj

Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, context As JsonSerializerContext) As Object

参数

utf8Json

ReadOnlySpan<Byte>

要分析的 JSON 文本。

returnType

Type

要转换为和返回的对象的类型。

context

JsonSerializerContext

可序列化类型的元数据提供程序。

返回

Object

JSON 值的 returnType 表示形式。

例外

ArgumentNullException

returnType null。

JsonException

JSON 无效，returnType 与 JSON 不兼容，或者 Stream 中有剩余数据。

NotSupportedException

returnType 或其可序列化成员没有兼容的 JsonConverter。

InvalidOperationException

提供的 context 上的 GetTypeInfo(Type) 方法未返回 returnType的兼容 JsonTypeInfo。

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

Source:

JsonSerializer.Read.Span.cs

将表示单个 JSON 值的 UTF-8 编码文本分析为由 jsonTypeInfo指定的实例。

public:
 static System::Object ^ Deserialize(ReadOnlySpan<System::Byte> utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static object? Deserialize (ReadOnlySpan<byte> utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> obj

Public Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo) As Object

参数

utf8Json

ReadOnlySpan<Byte>

要分析的 JSON 文本。

jsonTypeInfo

JsonTypeInfo

要转换的类型的元数据。

返回

Object

JSON 值的 jsonTypeInfo 表示形式。

例外

JsonException

JSON 无效，或缓冲区中存在剩余数据。

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Source:

JsonSerializer.Read.Element.cs

将表示单个 JSON 值的 JsonElement 转换为 TValue。

public static TValue? Deserialize<TValue> (this System.Text.Json.JsonElement element, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.JsonSerializerOptions -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (element As JsonElement, Optional options As JsonSerializerOptions = Nothing) As TValue

类型参数

TValue

要反序列化 JSON 值的类型。

参数

element

JsonElement

要转换的 JsonElement。

options

JsonSerializerOptions

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

返回

TValue

JSON 值的 TValue 表示形式。

例外

JsonException

TValue 与 JSON 不兼容。

NotSupportedException

TValue 或其可序列化成员没有兼容的 JsonConverter。

Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>)

Source:

JsonSerializer.Read.Element.cs

将表示单个 JSON 值的 JsonElement 转换为 TValue。

public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
 static TValue Deserialize(System::Text::Json::JsonElement element, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (this System.Text.Json.JsonElement element, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : System.Text.Json.JsonElement * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (element As JsonElement, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

类型参数

TValue

要反序列化 JSON 值的类型。

参数

element

JsonElement

要转换的 JsonElement。

jsonTypeInfo

JsonTypeInfo<TValue>

要转换的类型的元数据。

返回

TValue

JSON 值的 TValue 表示形式。

例外

ArgumentNullException

jsonTypeInfo null。

JsonException

TValue 与 JSON 不兼容。

NotSupportedException

TValue 或其可序列化成员没有兼容的 JsonConverter。

Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>)

Source:

JsonSerializer.Read.Utf8JsonReader.cs

将提供的读取器中的一个 JSON 值（包括对象或数组）读入 TValue。

public:
generic <typename TValue>
 static TValue Deserialize(System::Text::Json::Utf8JsonReader % reader, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : Utf8JsonReader * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

类型参数

TValue

要反序列化 JSON 值的类型。

参数

reader

Utf8JsonReader

要读取的读取器。

jsonTypeInfo

JsonTypeInfo<TValue>

要转换的类型的元数据。

返回

TValue

JSON 值的 TValue 表示形式。

例外

JsonException

JSON 无效，TValue 与 JSON 不兼容，或者无法从读取器读取值。

ArgumentException

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

NotSupportedException

TValue 或其可序列化成员没有兼容的 JsonConverter。

注解

如果 PropertyName 或 Nonereader 的 TokenType 属性，则读取器将通过一次调用 Read() 来确定值的开始。

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

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

用于创建 Utf8JsonReader 实例的 JsonReaderOptions 在冲突时优先于 JsonSerializerOptions。 因此，读取时使用 AllowTrailingCommas、MaxDepth和 CommentHandling。

Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>)

Source:

JsonSerializer.Read.Node.cs

将表示单个 JSON 值的 JsonNode 转换为 TValue。

public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
 static TValue Deserialize(System::Text::Json::Nodes::JsonNode ^ node, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (node As JsonNode, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

类型参数

TValue

要反序列化 JSON 值的类型。

参数

node

JsonNode

要转换的 JsonNode。

jsonTypeInfo

JsonTypeInfo<TValue>

要转换的类型的元数据。

返回

TValue

JSON 值的 TValue 表示形式。

例外

ArgumentNullException

jsonTypeInfo null。

JsonException

TValue 与 JSON 不兼容。

NotSupportedException

TValue 或其可序列化成员没有兼容的 JsonConverter。

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

Source:

JsonSerializer.Read.Utf8JsonReader.cs

将提供的读取器中的一个 JSON 值（包括对象或数组）读取到泛型类型参数指定的类型的实例中。

public static TValue? Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : Utf8JsonReader * System.Text.Json.JsonSerializerOptions -> 'Value

Public Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue

类型参数

TValue

JSON 值的目标类型。

参数

reader

Utf8JsonReader

要从中读取 JSON 的读取器。

options

JsonSerializerOptions

用于在读取期间控制序列化程序行为的选项。

返回

TValue

JSON 值的 TValue 表示形式。

例外

JsonException

JSON 无效。

-或-

TValue 与 JSON 不兼容。

-或-

无法从读取器读取值。

ArgumentException

reader 使用不支持的选项。

NotSupportedException

TValue 或其可序列化成员没有兼容的 JsonConverter。

注解

如果 JsonTokenType.PropertyName 或 JsonTokenType.Nonereader 的 TokenType 属性，则读取器将通过一次调用 Utf8JsonReader.Read() 来确定值的开始。

完成此方法后，reader 将放置在 JSON 值中的最终令牌上。 如果引发异常，则读取器将重置为调用该方法时处于的状态。

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

用于创建 Utf8JsonReader 实例的 JsonReaderOptions 在冲突时优先于 JsonSerializerOptions。 因此，读取时使用 JsonReaderOptions.AllowTrailingCommas、JsonReaderOptions.MaxDepth和 JsonReaderOptions.CommentHandling。

有关详细信息，请参阅 如何序列化和反序列化 JSON。

Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>)

Source:

JsonSerializer.Read.Document.cs

将表示单个 JSON 值的 JsonDocument 转换为 TValue。

public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
 static TValue Deserialize(System::Text::Json::JsonDocument ^ document, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (this System.Text.Json.JsonDocument document, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (document As JsonDocument, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

类型参数

TValue

要反序列化 JSON 值的类型。

参数

document

JsonDocument

要转换的 JsonDocument。

jsonTypeInfo

JsonTypeInfo<TValue>

要转换的类型的元数据。

返回

TValue

JSON 值的 TValue 表示形式。

例外

ArgumentNullException

document null。

-或-

jsonTypeInfo null。

JsonException

TValue 与 JSON 不兼容。

NotSupportedException

TValue 或其可序列化成员没有兼容的 JsonConverter。

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

Source:

JsonSerializer.Read.Node.cs

将表示单个 JSON 值的 JsonNode 转换为 TValue。

public static TValue? Deserialize<TValue> (this System.Text.Json.Nodes.JsonNode? node, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.Nodes.JsonNode * System.Text.Json.JsonSerializerOptions -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (node As JsonNode, Optional options As JsonSerializerOptions = Nothing) As TValue

类型参数

TValue

要反序列化 JSON 值的类型。

参数

node

JsonNode

要转换的 JsonNode。

options

JsonSerializerOptions

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

返回

TValue

JSON 值的 TValue 表示形式。

例外

JsonException

TValue 与 JSON 不兼容。

NotSupportedException

TValue 或其可序列化成员没有兼容的 JsonConverter。

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

Source:

JsonSerializer.Read.Document.cs

将表示单个 JSON 值的 JsonDocument 转换为 TValue。

public static TValue? Deserialize<TValue> (this System.Text.Json.JsonDocument document, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.Text.Json.JsonDocument * System.Text.Json.JsonSerializerOptions -> 'Value

<Extension()>
Public Function Deserialize(Of TValue) (document As JsonDocument, Optional options As JsonSerializerOptions = Nothing) As TValue

类型参数

TValue

要反序列化 JSON 值的类型。

参数

document

JsonDocument

要转换的 JsonDocument。

options

JsonSerializerOptions

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

返回

TValue

JSON 值的 TValue 表示形式。

例外

ArgumentNullException

document null。

JsonException

TValue 与 JSON 不兼容。

NotSupportedException

TValue 或其可序列化成员没有兼容的 JsonConverter。

Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>)

Source:

JsonSerializer.Read.String.cs

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

public:
generic <typename TValue>
 static TValue Deserialize(ReadOnlySpan<char> json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (ReadOnlySpan<char> json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : ReadOnlySpan<char> * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (json As ReadOnlySpan(Of Char), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

类型参数

TValue

要反序列化 JSON 值的类型。

参数

json

ReadOnlySpan<Char>

要分析的 JSON 文本。

jsonTypeInfo

JsonTypeInfo<TValue>

要转换的类型的元数据。

返回

TValue

JSON 值的 TValue 表示形式。

例外

ArgumentNullException

json null。

-或-

jsonTypeInfo null。

JsonException

JSON 无效。

-或-

TValue 与 JSON 不兼容。

-或-

字符串中存在超出单个 JSON 值的剩余数据。

NotSupportedException

TValue 或其可序列化成员没有兼容的 JsonConverter。

注解

使用 String 不像使用 UTF-8 方法那么高效，因为实现本机使用 UTF-8。

Deserialize<TValue>(String, JsonSerializerOptions)

Source:

JsonSerializer.Read.String.cs

将表示单个 JSON 值的文本分析为泛型类型参数指定的类型的实例。

public static TValue? Deserialize<TValue> (string json, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : string * System.Text.Json.JsonSerializerOptions -> 'Value

Public Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValue

类型参数

TValue

JSON 值的目标类型。

参数

json

String

要分析的 JSON 文本。

options

JsonSerializerOptions

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

返回

TValue

JSON 值的 TValue 表示形式。

例外

ArgumentNullException

json null。

JsonException

JSON 无效。

-或-

TValue 与 JSON 不兼容。

-或-

字符串中存在超出单个 JSON 值的剩余数据。

NotSupportedException

TValue 或其可序列化成员没有兼容的 JsonConverter。

注解

使用 String 不像使用 UTF-8 方法那么高效，因为实现本机使用 UTF-8。

有关详细信息，请参阅 如何序列化和反序列化 JSON。

Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions)

Source:

JsonSerializer.Read.String.cs

将表示单个 JSON 值的文本分析为泛型类型参数指定的类型的实例。

public static TValue? Deserialize<TValue> (ReadOnlySpan<char> json, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : ReadOnlySpan<char> * System.Text.Json.JsonSerializerOptions -> 'Value

Public Function Deserialize(Of TValue) (json As ReadOnlySpan(Of Char), Optional options As JsonSerializerOptions = Nothing) As TValue

类型参数

TValue

要反序列化 JSON 值的类型。

参数

json

ReadOnlySpan<Char>

要分析的 JSON 文本。

options

JsonSerializerOptions

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

返回

TValue

JSON 值的 TValue 表示形式。

例外

JsonException

JSON 无效。

-或-

TValue 与 JSON 不兼容。

-或-

跨度中存在超出单个 JSON 值的剩余数据。

NotSupportedException

TValue 或其可序列化成员没有兼容的 JsonConverter。

注解

使用 UTF-16 范围不像使用 UTF-8 方法那样高效，因为实现本机使用 UTF-8。

Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>)

Source:

JsonSerializer.Read.Span.cs

将表示单个 JSON 值的 UTF-8 编码文本分析为 TValue。

public:
generic <typename TValue>
 static TValue Deserialize(ReadOnlySpan<System::Byte> utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

类型参数

TValue

要反序列化 JSON 值的类型。

参数

utf8Json

ReadOnlySpan<Byte>

要分析的 JSON 文本。

jsonTypeInfo

JsonTypeInfo<TValue>

要转换的类型的元数据。

返回

TValue

JSON 值的 TValue 表示形式。

例外

JsonException

JSON 无效，TValue 与 JSON 不兼容，或者 Stream 中有剩余数据。

NotSupportedException

TValue 或其可序列化成员没有兼容的 JsonConverter。

Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions)

Source:

JsonSerializer.Read.Span.cs

将表示单个 JSON 值的 UTF-8 编码文本分析为泛型类型参数指定的类型的实例。

public static TValue? Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : ReadOnlySpan<byte> * System.Text.Json.JsonSerializerOptions -> 'Value

Public Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValue

类型参数

TValue

UTF-8 编码文本的目标类型。

参数

utf8Json

ReadOnlySpan<Byte>

要分析的 JSON 文本。

options

JsonSerializerOptions

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

返回

TValue

JSON 值的 TValue 表示形式。

例外

JsonException

JSON 无效。

-或-

TValue 与 JSON 不兼容。

-或-

跨度中存在超出单个 JSON 值的剩余数据。

NotSupportedException

TValue 或其可序列化成员没有兼容的 JsonConverter。

注解

有关详细信息，请参阅 如何序列化和反序列化 JSON。

Deserialize<TValue>(Stream, JsonTypeInfo<TValue>)

Source:

JsonSerializer.Read.Stream.cs

将表示单个 JSON 值的 UTF-8 编码文本读入 TValue。 流将读取到完成。

public:
generic <typename TValue>
 static TValue Deserialize(System::IO::Stream ^ utf8Json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

类型参数

TValue

要反序列化 JSON 值的类型。

参数

utf8Json

Stream

要分析的 JSON 数据。

jsonTypeInfo

JsonTypeInfo<TValue>

要转换的类型的元数据。

返回

TValue

JSON 值的 TValue 表示形式。

例外

ArgumentNullException

utf8Json 或 jsonTypeInfonull。

JsonException

JSON 无效，TValue 与 JSON 不兼容，或者 Stream 中有剩余数据。

NotSupportedException

TValue 或其可序列化成员没有兼容的 JsonConverter。

Deserialize<TValue>(Stream, JsonSerializerOptions)

Source:

JsonSerializer.Read.Stream.cs

将表示单个 JSON 值的 UTF-8 编码文本读入 TValue。 流将读取到完成。

public static TValue? Deserialize<TValue> (System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions? options = default);

static member Deserialize : System.IO.Stream * System.Text.Json.JsonSerializerOptions -> 'Value

Public Function Deserialize(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing) As TValue

类型参数

TValue

要反序列化 JSON 值的类型。

参数

utf8Json

Stream

要分析的 JSON 数据。

options

JsonSerializerOptions

用于控制读取过程中行为的选项。

返回

TValue

JSON 值的 TValue 表示形式。

例外

ArgumentNullException

utf8Json null。

JsonException

JSON 无效，TValue 与 JSON 不兼容，或者 Stream 中有剩余数据。

NotSupportedException

TValue 或其可序列化成员没有兼容的 JsonConverter。

Deserialize<TValue>(String, JsonTypeInfo<TValue>)

Source:

JsonSerializer.Read.String.cs

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

public:
generic <typename TValue>
 static TValue Deserialize(System::String ^ json, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static TValue? Deserialize<TValue> (string json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member Deserialize : string * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> 'Value

Public Function Deserialize(Of TValue) (json As String, jsonTypeInfo As JsonTypeInfo(Of TValue)) As TValue

类型参数

TValue

要反序列化 JSON 值的类型。

参数

json

String

要分析的 JSON 文本。

jsonTypeInfo

JsonTypeInfo<TValue>

要转换的类型的元数据。

返回

TValue

JSON 值的 TValue 表示形式。

例外

ArgumentNullException

json null。

-或-

jsonTypeInfo null。

JsonException

JSON 无效。

-或-

TValue 与 JSON 不兼容。

-或-

字符串中存在超出单个 JSON 值的剩余数据。

NotSupportedException

TValue 或其可序列化成员没有兼容的 JsonConverter。

注解

使用 String 不像使用 UTF-8 方法那么高效，因为实现本机使用 UTF-8。