JsonSerializer.Deserialize Метод

Определение

Перегрузки

Deserialize(Stream, JsonTypeInfo)

Считывает текст в кодировке UTF-8, представляющий одно значение JSON, в экземпляр, указанный в jsonTypeInfo. Поток будет считываться до завершения.

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

Считывает одно значение JSON (включая объекты или массивы) из предоставленного средства чтения в returnType.

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

Считывает одно значение JSON (включая объекты или массивы) из предоставленного средства чтения и преобразует его в экземпляр указанного типа.

Deserialize(JsonNode, Type, JsonSerializerOptions)

Преобразует объект , JsonNode представляющий одно значение JSON, в .returnType

Deserialize(JsonElement, Type, JsonSerializerContext)

Преобразует объект , JsonElement представляющий одно значение JSON, в .returnType

Deserialize(JsonElement, Type, JsonSerializerOptions)

Преобразует объект , JsonElement представляющий одно значение JSON, в .returnType

Deserialize(JsonDocument, Type, JsonSerializerContext)

Преобразует объект , JsonDocument представляющий одно значение JSON, в .returnType

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Преобразует объект , JsonDocument представляющий одно значение JSON, в .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(JsonNode, Type, JsonSerializerContext)

Преобразует объект , JsonNode представляющий одно значение JSON, в .returnType

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

Выполняет синтаксический анализ текста в кодировке UTF-8, представляющего одно значение JSON, в экземпляр указанного типа.

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

Анализирует текст в кодировке UTF-8, представляющий одно значение JSON, в .returnType

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

Анализирует текст в кодировке UTF-8, представляющий одно значение JSON, в экземпляр, указанный в jsonTypeInfo.

Deserialize(String, JsonTypeInfo)

Анализирует текст, представляющий одно значение JSON, в экземпляр, указанный в jsonTypeInfo.

Deserialize(JsonDocument, JsonTypeInfo)

Преобразует объект , JsonDocument представляющий одно значение JSON, в экземпляр, заданный .jsonTypeInfo

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

Анализирует текст, представляющий одно значение JSON, в экземпляр, указанный в jsonTypeInfo.

Deserialize(JsonNode, JsonTypeInfo)

Преобразует объект , JsonNode представляющий одно значение JSON, в экземпляр, заданный .jsonTypeInfo

Deserialize(Utf8JsonReader, JsonTypeInfo)

Считывает одно значение JSON (включая объекты или массивы) из предоставленного средства чтения в экземпляр, заданный jsonTypeInfo.

Deserialize(Stream, Type, JsonSerializerOptions)

Считывает текст в кодировке UTF-8, представляющий одно значение JSON, в .returnType Поток будет считываться до завершения.

Deserialize(Stream, Type, JsonSerializerContext)

Считывает текст в кодировке UTF-8, представляющий одно значение JSON, в .returnType Поток будет считываться до завершения.

Deserialize(JsonElement, JsonTypeInfo)

Преобразует объект , JsonElement представляющий одно значение JSON, в экземпляр, заданный .jsonTypeInfo

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

Считывает одно значение JSON (включая объекты или массивы) из предоставленного средства чтения в TValue.

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

Преобразует объект , JsonDocument представляющий одно значение JSON, в .TValue

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

Считывает одно значение JSON (включая объекты или массивы) из предоставленного модуля чтения в экземпляр типа, заданного параметром универсального типа.

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

Преобразует объект , JsonNode представляющий одно значение JSON, в .TValue

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

Преобразует объект , JsonNode представляющий одно значение JSON, в .TValue

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

Преобразует объект , JsonElement представляющий одно значение JSON, в .TValue

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Преобразует объект , JsonElement представляющий одно значение JSON, в .TValue

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

Преобразует объект , JsonDocument представляющий одно значение JSON, в .TValue

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

Выполняет синтаксический анализ текста, представляющего одно значение JSON, в экземпляр типа, заданного параметром универсального типа.

Deserialize<TValue>(String, JsonSerializerOptions)

Выполняет синтаксический анализ текста, представляющего одно значение JSON, в экземпляр типа, заданного параметром универсального типа.

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

Анализирует текст, представляющий одно значение JSON, в .TValue

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

Анализирует текст в кодировке UTF-8, представляющий одно значение JSON, в .TValue

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

Выполняет синтаксический анализ текста в кодировке UTF-8, представляющего одно значение JSON, в экземпляр типа, заданного параметром универсального типа.

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

Считывает текст в кодировке UTF-8, представляющий одно значение JSON, в .TValue Поток будет считываться до завершения.

Deserialize<TValue>(Stream, JsonSerializerOptions)

Считывает текст в кодировке UTF-8, представляющий одно значение JSON, в .TValue Поток будет считываться до завершения.

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

Анализирует текст, представляющий одно значение JSON, в .TValue

Deserialize(Stream, JsonTypeInfo)

Исходный код:
JsonSerializer.Read.Stream.cs
Исходный код:
JsonSerializer.Read.Stream.cs

Считывает текст в кодировке UTF-8, представляющий одно значение JSON, в экземпляр, указанный в 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

Метаданные о преобразуемом типе.

Возвращаемое значение

Представление jsonTypeInfo данного значения JSON.

Исключения

Параметр utf8Json или jsonTypeInfo имеет значение null.

Недопустимый код JSON или в потоке есть оставшиеся данные.

Применяется к

Deserialize(Utf8JsonReader, Type, JsonSerializerContext)

Исходный код:
JsonSerializer.Read.Utf8JsonReader.cs
Исходный код:
JsonSerializer.Read.Utf8JsonReader.cs
Исходный код:
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

Поставщик метаданных для сериализуемых типов.

Возвращаемое значение

Представление returnType данного значения JSON.

Исключения

Параметр returnType или context имеет значение null.

Недопустимый формат JSON, returnType несовместим с JSON, или не удалось прочитать значение из модуля чтения.

reader использует неподдерживаемые параметры.

Совместимые объекты JsonConverter для returnType или его сериализуемых членов отсутствуют.

Метод GetTypeInfo(Type) в предоставленном context объекте не вернул совместимый JsonTypeInfo для returnType.

Комментарии

TokenType Если свойство имеет reader значение PropertyName или None, средство чтения будет расширено одним вызовом , Read() чтобы определить начало значения.

После завершения этого метода reader позиционируется в окончательном маркере в значении JSON. При возникновении исключения средство чтения сбрасывается в состояние, в которое оно находилось при вызове метода.

Этот метод создает копию данных, с помощью функции чтения, поэтому не требуется, чтобы вызывающий объект поддерживал целостность данных после возврата этого метода.

Объект , JsonReaderOptions используемый для создания экземпляра Utf8JsonReader , имеет приоритет над , JsonSerializerOptions когда они конфликтуют. Следовательно, AllowTrailingCommasпри чтении используются , MaxDepthи CommentHandling .

Применяется к

Deserialize(Utf8JsonReader, Type, JsonSerializerOptions)

Исходный код:
JsonSerializer.Read.Utf8JsonReader.cs
Исходный код:
JsonSerializer.Read.Utf8JsonReader.cs
Исходный код:
JsonSerializer.Read.Utf8JsonReader.cs

Считывает одно значение JSON (включая объекты или массивы) из предоставленного средства чтения и преобразует его в экземпляр указанного типа.

public static object? Deserialize (ref System.Text.Json.Utf8JsonReader reader, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
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 Shared Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Public Function Deserialize (ByRef reader As Utf8JsonReader, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Параметры

reader
Utf8JsonReader

Модуль чтения, из которого читается JSON.

returnType
Type

Тип объекта для преобразования и возврата.

options
JsonSerializerOptions

Параметры для управления поведением сериализатора во время чтения.

Возвращаемое значение

Представление returnType данного значения JSON.

Исключения

returnType имеет значение null.

Недопустимый JSON.

-или-

returnType несовместим с JSON.

-или-

Не удалось считать значение из модуля чтения.

reader использует неподдерживаемые параметры.

Совместимые объекты JsonConverter для returnType или его сериализуемых членов отсутствуют.

Комментарии

TokenType Если свойство имеет reader значение JsonTokenType.PropertyName или JsonTokenType.None, средство чтения будет расширено одним вызовом , Utf8JsonReader.Read() чтобы определить начало значения.

После завершения этого метода reader будет располагаться в конечном токене в значении JSON. При возникновении исключения средство чтения сбрасывается в состояние, в которое оно находилось при вызове метода.

Этот метод создает копию данных, с помощью функции чтения, поэтому не требуется, чтобы вызывающий объект поддерживал целостность данных после возврата этого метода.

Объект , JsonReaderOptions используемый для создания экземпляра Utf8JsonReader , имеет приоритет над , JsonSerializerOptions когда они конфликтуют. Следовательно, JsonReaderOptions.AllowTrailingCommasпри чтении используются , JsonReaderOptions.MaxDepthи JsonReaderOptions.CommentHandling .

Дополнительные сведения см. в статье Сериализация и десериализация JSON.

Применяется к

Deserialize(JsonNode, Type, JsonSerializerOptions)

Исходный код:
JsonSerializer.Read.Node.cs
Исходный код:
JsonSerializer.Read.Node.cs
Исходный код:
JsonSerializer.Read.Node.cs

Преобразует объект , JsonNode представляющий одно значение JSON, в .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

Параметры для управления поведением во время анализа.

Возвращаемое значение

Представление returnType данного значения JSON.

Исключения

returnType несовместим с JSON.

Совместимые объекты JsonConverter для returnType или его сериализуемых членов отсутствуют.

Применяется к

Deserialize(JsonElement, Type, JsonSerializerContext)

Исходный код:
JsonSerializer.Read.Element.cs
Исходный код:
JsonSerializer.Read.Element.cs
Исходный код:
JsonSerializer.Read.Element.cs

Преобразует объект , JsonElement представляющий одно значение JSON, в .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

Поставщик метаданных для сериализуемых типов.

Возвращаемое значение

Представление returnType данного значения JSON.

Исключения

returnType имеет значение null.

-или-

context имеет значение null.

Недопустимый JSON.

-или-

returnType несовместим с JSON.

-или-

Остались данные в строке больше одного значения JSON.

Совместимые объекты JsonConverter для returnType или его сериализуемых членов отсутствуют.

Метод GetTypeInfo(Type) предоставленного context возвращает null преобразуемый тип.

Применяется к

Deserialize(JsonElement, Type, JsonSerializerOptions)

Исходный код:
JsonSerializer.Read.Element.cs
Исходный код:
JsonSerializer.Read.Element.cs
Исходный код:
JsonSerializer.Read.Element.cs

Преобразует объект , JsonElement представляющий одно значение JSON, в .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

Параметры для управления поведением во время анализа.

Возвращаемое значение

Представление returnType данного значения JSON.

Исключения

returnType имеет значение null.

returnType несовместим с JSON.

Совместимые объекты JsonConverter для returnType или его сериализуемых членов отсутствуют.

Применяется к

Deserialize(JsonDocument, Type, JsonSerializerContext)

Исходный код:
JsonSerializer.Read.Document.cs
Исходный код:
JsonSerializer.Read.Document.cs
Исходный код:
JsonSerializer.Read.Document.cs

Преобразует объект , JsonDocument представляющий одно значение JSON, в .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

Поставщик метаданных для сериализуемых типов.

Возвращаемое значение

Представление returnType данного значения JSON.

Исключения

document имеет значение null.

-или-

returnType имеет значение null.

-или-

context имеет значение null.

Недопустимый JSON.

-или-

returnType несовместим с JSON.

-или-

Остались данные в строке больше одного значения JSON.

Совместимые объекты JsonConverter для returnType или его сериализуемых членов отсутствуют.

Метод GetTypeInfo(Type) предоставленного context возвращает null преобразуемый тип.

Применяется к

Deserialize(JsonDocument, Type, JsonSerializerOptions)

Исходный код:
JsonSerializer.Read.Document.cs
Исходный код:
JsonSerializer.Read.Document.cs
Исходный код:
JsonSerializer.Read.Document.cs

Преобразует объект , JsonDocument представляющий одно значение JSON, в .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

Параметры для управления поведением во время анализа.

Возвращаемое значение

Представление returnType данного значения JSON.

Исключения

Параметр document или returnType имеет значение null.

returnType несовместим с JSON.

Совместимые объекты JsonConverter для returnType или его сериализуемых членов отсутствуют.

Применяется к

Deserialize(String, Type, JsonSerializerContext)

Исходный код:
JsonSerializer.Read.String.cs
Исходный код:
JsonSerializer.Read.String.cs
Исходный код:
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

Поставщик метаданных для сериализуемых типов.

Возвращаемое значение

Представление returnType данного значения JSON.

Исключения

Параметр json или returnType имеет значение null.

-или-

context имеет значение null.

Недопустимый JSON.

-или-

returnType несовместим с JSON.

-или-

Остались данные в строке больше одного значения JSON.

Совместимые объекты JsonConverter для returnType или его сериализуемых членов отсутствуют.

Метод GetTypeInfo(Type) предоставленного context возвращает null преобразуемый тип.

Комментарии

String Использование не так эффективно, как использование методов UTF-8, так как реализация изначально использует UTF-8.

Применяется к

Deserialize(String, Type, JsonSerializerOptions)

Исходный код:
JsonSerializer.Read.String.cs
Исходный код:
JsonSerializer.Read.String.cs
Исходный код:
JsonSerializer.Read.String.cs

Выполняет синтаксический анализ текста, представляющего одно значение JSON, в экземпляр указанного типа.

public static object? Deserialize (string json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
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 Shared Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
Public Function Deserialize (json As String, returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object

Параметры

json
String

Анализируемый текст JSON.

returnType
Type

Тип объекта для преобразования и возврата.

options
JsonSerializerOptions

Параметры для управления поведением во время анализа.

Возвращаемое значение

Представление returnType данного значения JSON.

Исключения

Параметр json или returnType имеет значение null.

Недопустимый JSON.

-или-

TValue несовместим с JSON.

-или-

Остались данные в строке больше одного значения JSON.

Совместимые объекты JsonConverter для returnType или его сериализуемых членов отсутствуют.

Комментарии

String Использование не так эффективно, как использование методов UTF-8, так как реализация изначально использует UTF-8.

Дополнительные сведения см. в статье Сериализация и десериализация JSON.

Применяется к

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext)

Исходный код:
JsonSerializer.Read.String.cs
Исходный код:
JsonSerializer.Read.String.cs
Исходный код:
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

Поставщик метаданных для сериализуемых типов.

Возвращаемое значение

Представление returnType данного значения JSON.

Исключения

Параметр json или returnType имеет значение null.

-или-

context имеет значение null.

Недопустимый JSON.

-или-

returnType несовместим с JSON.

-или-

Остались данные в строке больше одного значения JSON.

Совместимые объекты JsonConverter для returnType или его сериализуемых членов отсутствуют.

Метод GetTypeInfo(Type) предоставленного context возвращает null преобразуемый тип.

Комментарии

String Использование не так эффективно, как использование методов UTF-8, так как реализация изначально использует UTF-8.

Применяется к

Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions)

Исходный код:
JsonSerializer.Read.String.cs
Исходный код:
JsonSerializer.Read.String.cs
Исходный код:
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

Параметры для управления поведением во время анализа.

Возвращаемое значение

Представление returnType данного значения JSON.

Исключения

returnType имеет значение null.

Недопустимый JSON.

-или-

returnType несовместим с JSON.

-или-

Остались данные в диапазоне больше одного значения JSON.

Совместимые объекты JsonConverter для returnType или его сериализуемых членов отсутствуют.

Комментарии

Использование диапазона UTF-16 не так эффективно, как использование методов UTF-8, так как реализация изначально использует UTF-8.

Применяется к

Deserialize(JsonNode, Type, JsonSerializerContext)

Исходный код:
JsonSerializer.Read.Node.cs
Исходный код:
JsonSerializer.Read.Node.cs
Исходный код:
JsonSerializer.Read.Node.cs

Преобразует объект , JsonNode представляющий одно значение JSON, в .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

Поставщик метаданных для сериализуемых типов.

Возвращаемое значение

Представление returnType данного значения JSON.

Исключения

returnType имеет значение null.

-или-

context имеет значение null.

Недопустимый JSON.

-или-

returnType несовместим с JSON.

-или-

Остались данные в строке больше одного значения JSON.

Совместимые объекты JsonConverter для returnType или его сериализуемых членов отсутствуют.

Метод GetTypeInfo(Type) предоставленного context возвращает null преобразуемый тип.

Применяется к

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions)

Исходный код:
JsonSerializer.Read.Span.cs
Исходный код:
JsonSerializer.Read.Span.cs
Исходный код:
JsonSerializer.Read.Span.cs

Выполняет синтаксический анализ текста в кодировке UTF-8, представляющего одно значение JSON, в экземпляр указанного типа.

public static object? Deserialize (ReadOnlySpan<byte> utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default);
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 Shared Function Deserialize (utf8Json As ReadOnlySpan(Of Byte), returnType As Type, Optional options As JsonSerializerOptions = Nothing) As Object
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

Параметры для управления поведением во время анализа.

Возвращаемое значение

Представление returnType данного значения JSON.

Исключения

returnType имеет значение null.

Недопустимый JSON.

-или-

returnType несовместим с JSON.

-или-

Остались данные в диапазоне больше одного значения JSON.

Совместимые объекты JsonConverter для returnType или его сериализуемых членов отсутствуют.

Комментарии

Дополнительные сведения см. в статье Сериализация и десериализация JSON.

Применяется к

Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext)

Исходный код:
JsonSerializer.Read.Span.cs
Исходный код:
JsonSerializer.Read.Span.cs
Исходный код:
JsonSerializer.Read.Span.cs

Анализирует текст в кодировке UTF-8, представляющий одно значение JSON, в .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

Поставщик метаданных для сериализуемых типов.

Возвращаемое значение

Представление returnType данного значения JSON.

Исключения

returnType имеет значение null.

Json является недопустимым, returnType несовместим с JSON или есть оставшиеся данные в Stream.

Совместимые объекты JsonConverter для returnType или его сериализуемых членов отсутствуют.

Метод GetTypeInfo(Type) в предоставленном context объекте не вернул совместимый JsonTypeInfo для returnType.

Применяется к

Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo)

Исходный код:
JsonSerializer.Read.Span.cs
Исходный код:
JsonSerializer.Read.Span.cs

Анализирует текст в кодировке UTF-8, представляющий одно значение JSON, в экземпляр, указанный в 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

Метаданные о преобразуемом типе.

Возвращаемое значение

Представление jsonTypeInfo данного значения JSON.

Исключения

Json является недопустимым, или в буфере есть оставшиеся данные.

Применяется к

Deserialize(String, JsonTypeInfo)

Исходный код:
JsonSerializer.Read.String.cs
Исходный код:
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

Метаданные о преобразуемом типе.

Возвращаемое значение

Представление jsonTypeInfo данного значения JSON.

Исключения

json имеет значение null.

-или-

jsonTypeInfo имеет значение null.

Недопустимый JSON.

-или-

Остались данные в строке больше одного значения JSON.

Комментарии

String Использование не так эффективно, как использование методов UTF-8, так как реализация изначально использует UTF-8.

Применяется к

Deserialize(JsonDocument, JsonTypeInfo)

Исходный код:
JsonSerializer.Read.Document.cs
Исходный код:
JsonSerializer.Read.Document.cs

Преобразует объект , JsonDocument представляющий одно значение JSON, в экземпляр, указанный в 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

Метаданные о преобразуемом типе.

Возвращаемое значение

Представление jsonTypeInfo данного значения JSON.

Исключения

document имеет значение null.

-или-

jsonTypeInfo имеет значение null.

Применяется к

Deserialize(ReadOnlySpan<Char>, JsonTypeInfo)

Исходный код:
JsonSerializer.Read.String.cs
Исходный код:
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

Метаданные о преобразуемом типе.

Возвращаемое значение

Представление jsonTypeInfo данного значения JSON.

Исключения

jsonTypeInfo имеет значение null.

Недопустимый JSON.

-или-

Остались данные в строке больше одного значения JSON.

Комментарии

String Использование не так эффективно, как использование методов UTF-8, так как реализация изначально использует UTF-8.

Применяется к

Deserialize(JsonNode, JsonTypeInfo)

Исходный код:
JsonSerializer.Read.Node.cs
Исходный код:
JsonSerializer.Read.Node.cs

Преобразует объект , JsonNode представляющий одно значение JSON, в экземпляр, указанный в 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

Метаданные о преобразуемом типе.

Возвращаемое значение

Представление jsonTypeInfo данного значения JSON.

Исключения

jsonTypeInfo имеет значение null.

Применяется к

Deserialize(Utf8JsonReader, JsonTypeInfo)

Исходный код:
JsonSerializer.Read.Utf8JsonReader.cs
Исходный код:
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

Метаданные о преобразуемом типе.

Возвращаемое значение

Представление jsonTypeInfo данного значения JSON.

Исключения

Недопустимый формат JSON, jsonTypeInfo несовместим с JSON, или не удалось прочитать значение из модуля чтения.

reader использует неподдерживаемые параметры.

Комментарии

TokenType Если свойство имеет reader значение PropertyName или None, средство чтения будет расширено одним вызовом для Read() определения начала значения.

После завершения этого метода reader будет позиционироваться в последнем токене в значении JSON. Если возникает исключение, средство чтения сбрасывается в состояние, в которое оно находилось при вызове метода.

Этот метод создает копию данных, на которые действовал читатель, поэтому не требуется, чтобы вызывающий объект поддерживал целостность данных после возврата этого метода.

Объект , JsonReaderOptions используемый для создания экземпляра , Utf8JsonReader имеет приоритет над JsonSerializerOptions , когда они конфликтуют. Таким образом, AllowTrailingCommasпри чтении используются , MaxDepthи CommentHandling .

Применяется к

Deserialize(Stream, Type, JsonSerializerOptions)

Исходный код:
JsonSerializer.Read.Stream.cs
Исходный код:
JsonSerializer.Read.Stream.cs
Исходный код:
JsonSerializer.Read.Stream.cs

Считывает текст в кодировке UTF-8, представляющий одно значение JSON в .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

Параметры для управления поведением во время чтения.

Возвращаемое значение

Представление returnType данного значения JSON.

Исключения

Параметр utf8Json или returnType имеет значение null.

Json недопустим returnType , несовместим с JSON или в потоке остались данные.

Совместимые объекты JsonConverter для returnType или его сериализуемых членов отсутствуют.

Применяется к

Deserialize(Stream, Type, JsonSerializerContext)

Исходный код:
JsonSerializer.Read.Stream.cs
Исходный код:
JsonSerializer.Read.Stream.cs
Исходный код:
JsonSerializer.Read.Stream.cs

Считывает текст в кодировке UTF-8, представляющий одно значение JSON в .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

Поставщик метаданных для сериализуемых типов.

Возвращаемое значение

Представление returnType данного значения JSON.

Исключения

Значение параметра utf8Json, returnType или context равно null.

Json недопустим returnType , несовместим с JSON или в потоке остались данные.

Совместимые объекты JsonConverter для returnType или его сериализуемых членов отсутствуют.

Метод GetTypeInfo(Type) в предоставленном context не вернул совместимый JsonTypeInfo для returnType.

Применяется к

Deserialize(JsonElement, JsonTypeInfo)

Исходный код:
JsonSerializer.Read.Element.cs
Исходный код:
JsonSerializer.Read.Element.cs

Преобразует объект , JsonElement представляющий одно значение JSON, в экземпляр, указанный в 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

Метаданные о преобразуемом типе.

Возвращаемое значение

Представление jsonTypeInfo данного значения JSON.

Исключения

jsonTypeInfo имеет значение null.

Применяется к

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

Исходный код:
JsonSerializer.Read.Utf8JsonReader.cs
Исходный код:
JsonSerializer.Read.Utf8JsonReader.cs
Исходный код:
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

Представление TValue данного значения JSON.

Исключения

Недопустимый формат JSON, TValue несовместим с JSON, или не удалось прочитать значение из модуля чтения.

reader использует неподдерживаемые параметры.

Совместимые объекты JsonConverter для TValue или его сериализуемых членов отсутствуют.

Комментарии

TokenType Если свойство имеет reader значение PropertyName или None, средство чтения будет расширено одним вызовом для Read() определения начала значения.

После завершения этого метода reader позиционируется в последнем токене в значении JSON. Если возникает исключение, средство чтения сбрасывается в состояние, в которое оно находилось при вызове метода.

Этот метод создает копию данных, на которые действовал читатель, поэтому не требуется, чтобы вызывающий объект поддерживал целостность данных после возврата этого метода.

Объект , JsonReaderOptions используемый для создания экземпляра , Utf8JsonReader имеет приоритет над JsonSerializerOptions , когда они конфликтуют. Таким образом, AllowTrailingCommasпри чтении используются , MaxDepthи CommentHandling .

Применяется к

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

Исходный код:
JsonSerializer.Read.Document.cs
Исходный код:
JsonSerializer.Read.Document.cs
Исходный код:
JsonSerializer.Read.Document.cs

Преобразует объект , JsonDocument представляющий одно значение JSON, 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

Представление TValue данного значения JSON.

Исключения

document имеет значение null.

-или-

jsonTypeInfo имеет значение null.

TValue несовместим с JSON.

Совместимые объекты JsonConverter для TValue или его сериализуемых членов отсутствуют.

Применяется к

Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions)

Исходный код:
JsonSerializer.Read.Utf8JsonReader.cs
Исходный код:
JsonSerializer.Read.Utf8JsonReader.cs
Исходный код:
JsonSerializer.Read.Utf8JsonReader.cs

Считывает одно значение JSON (включая объекты или массивы) из предоставленного модуля чтения в экземпляр типа, заданного параметром универсального типа.

public static TValue? Deserialize<TValue> (ref System.Text.Json.Utf8JsonReader reader, System.Text.Json.JsonSerializerOptions? options = default);
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 Shared Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue
Public Function Deserialize(Of TValue) (ByRef reader As Utf8JsonReader, Optional options As JsonSerializerOptions = Nothing) As TValue

Параметры типа

TValue

Целевой тип значения JSON.

Параметры

reader
Utf8JsonReader

Модуль чтения, из которого читается JSON.

options
JsonSerializerOptions

Параметры для управления поведением сериализатора во время чтения.

Возвращаемое значение

TValue

Представление TValue данного значения JSON.

Исключения

Недопустимый JSON.

-или-

TValue несовместим с JSON.

-или-

Не удалось считать значение из модуля чтения.

reader использует неподдерживаемые параметры.

Совместимые объекты JsonConverter для TValue или его сериализуемых членов отсутствуют.

Комментарии

TokenType Если свойство имеет reader значение JsonTokenType.PropertyName или JsonTokenType.None, средство чтения будет расширено одним вызовом для Utf8JsonReader.Read() определения начала значения.

После завершения этого метода reader будет позиционироваться в последнем токене в значении JSON. Если возникает исключение, средство чтения сбрасывается в состояние, в которое оно находилось при вызове метода.

Этот метод создает копию данных, на которые действовал читатель, поэтому не требуется, чтобы вызывающий объект поддерживал целостность данных после возврата этого метода.

Объект , JsonReaderOptions используемый для создания экземпляра , Utf8JsonReader имеет приоритет над JsonSerializerOptions , когда они конфликтуют. Таким образом, JsonReaderOptions.AllowTrailingCommasпри чтении используются , JsonReaderOptions.MaxDepthи JsonReaderOptions.CommentHandling .

Дополнительные сведения см. в разделе Сериализация и десериализация JSON.

Применяется к

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

Исходный код:
JsonSerializer.Read.Node.cs
Исходный код:
JsonSerializer.Read.Node.cs
Исходный код:
JsonSerializer.Read.Node.cs

Преобразует объект , JsonNode представляющий одно значение JSON, 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

Представление TValue данного значения JSON.

Исключения

jsonTypeInfo имеет значение null.

TValue несовместим с JSON.

Совместимые объекты JsonConverter для TValue или его сериализуемых членов отсутствуют.

Применяется к

Deserialize<TValue>(JsonNode, JsonSerializerOptions)

Исходный код:
JsonSerializer.Read.Node.cs
Исходный код:
JsonSerializer.Read.Node.cs
Исходный код:
JsonSerializer.Read.Node.cs

Преобразует объект , JsonNode представляющий одно значение JSON, 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

Представление TValue данного значения JSON.

Исключения

TValue несовместим с JSON.

Совместимые объекты JsonConverter для TValue или его сериализуемых членов отсутствуют.

Применяется к

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

Исходный код:
JsonSerializer.Read.Element.cs
Исходный код:
JsonSerializer.Read.Element.cs
Исходный код:
JsonSerializer.Read.Element.cs

Преобразует объект , JsonElement представляющий одно значение JSON, 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

Представление TValue данного значения JSON.

Исключения

jsonTypeInfo имеет значение null.

TValue несовместим с JSON.

Совместимые объекты JsonConverter для TValue или его сериализуемых членов отсутствуют.

Применяется к

Deserialize<TValue>(JsonElement, JsonSerializerOptions)

Исходный код:
JsonSerializer.Read.Element.cs
Исходный код:
JsonSerializer.Read.Element.cs
Исходный код:
JsonSerializer.Read.Element.cs

Преобразует объект , JsonElement представляющий одно значение JSON, 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

Представление TValue данного значения JSON.

Исключения

TValue несовместим с JSON.

Совместимые объекты JsonConverter для TValue или его сериализуемых членов отсутствуют.

Применяется к

Deserialize<TValue>(JsonDocument, JsonSerializerOptions)

Исходный код:
JsonSerializer.Read.Document.cs
Исходный код:
JsonSerializer.Read.Document.cs
Исходный код:
JsonSerializer.Read.Document.cs

Преобразует объект , JsonDocument представляющий одно значение JSON, 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

Представление TValue данного значения JSON.

Исключения

document имеет значение null.

TValue несовместим с JSON.

Совместимые объекты JsonConverter для TValue или его сериализуемых членов отсутствуют.

Применяется к

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

Исходный код:
JsonSerializer.Read.String.cs
Исходный код:
JsonSerializer.Read.String.cs
Исходный код:
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

Представление TValue данного значения JSON.

Исключения

Недопустимый JSON.

-или-

TValue несовместим с JSON.

-или-

Остались данные в диапазоне больше одного значения JSON.

Совместимые объекты JsonConverter для TValue или его сериализуемых членов отсутствуют.

Комментарии

Использование диапазона UTF-16 не так эффективно, как использование методов UTF-8, так как реализация изначально использует UTF-8.

Применяется к

Deserialize<TValue>(String, JsonSerializerOptions)

Исходный код:
JsonSerializer.Read.String.cs
Исходный код:
JsonSerializer.Read.String.cs
Исходный код:
JsonSerializer.Read.String.cs

Выполняет синтаксический анализ текста, представляющего одно значение JSON, в экземпляр типа, заданного параметром универсального типа.

public static TValue? Deserialize<TValue> (string json, System.Text.Json.JsonSerializerOptions? options = default);
public static TValue Deserialize<TValue> (string json, System.Text.Json.JsonSerializerOptions options = default);
static member Deserialize : string * System.Text.Json.JsonSerializerOptions -> 'Value
Public Shared Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValue
Public Function Deserialize(Of TValue) (json As String, Optional options As JsonSerializerOptions = Nothing) As TValue

Параметры типа

TValue

Целевой тип значения JSON.

Параметры

json
String

Анализируемый текст JSON.

options
JsonSerializerOptions

Параметры для управления поведением во время анализа.

Возвращаемое значение

TValue

Представление TValue данного значения JSON.

Исключения

json имеет значение null.

Недопустимый JSON.

-или-

TValue несовместим с JSON.

-или-

Остались данные в строке больше одного значения JSON.

Совместимые объекты JsonConverter для TValue или его сериализуемых членов отсутствуют.

Комментарии

String Использование не так эффективно, как использование методов UTF-8, так как реализация изначально использует UTF-8.

Дополнительные сведения см. в разделе Сериализация и десериализация JSON.

Применяется к

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

Исходный код:
JsonSerializer.Read.String.cs
Исходный код:
JsonSerializer.Read.String.cs
Исходный код:
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

Представление TValue данного значения JSON.

Исключения

json имеет значение null.

-или-

jsonTypeInfo имеет значение null.

Недопустимый JSON.

-или-

TValue несовместим с JSON.

-или-

Остались данные в строке больше одного значения JSON.

Совместимые объекты JsonConverter для TValue или его сериализуемых членов отсутствуют.

Комментарии

String Использование не так эффективно, как использование методов UTF-8, так как реализация изначально использует UTF-8.

Применяется к

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

Исходный код:
JsonSerializer.Read.Span.cs
Исходный код:
JsonSerializer.Read.Span.cs
Исходный код:
JsonSerializer.Read.Span.cs

Анализирует текст в кодировке UTF-8, представляющий одно значение JSON, в .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

Представление TValue данного значения JSON.

Исключения

Json является недопустимым, TValue несовместим с JSON или в потоке есть оставшиеся данные.

Совместимые объекты JsonConverter для TValue или его сериализуемых членов отсутствуют.

Применяется к

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

Исходный код:
JsonSerializer.Read.Span.cs
Исходный код:
JsonSerializer.Read.Span.cs
Исходный код:
JsonSerializer.Read.Span.cs

Выполняет синтаксический анализ текста в кодировке UTF-8, представляющего одно значение JSON, в экземпляр типа, заданного параметром универсального типа.

public static TValue? Deserialize<TValue> (ReadOnlySpan<byte> utf8Json, System.Text.Json.JsonSerializerOptions? options = default);
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 Shared Function Deserialize(Of TValue) (utf8Json As ReadOnlySpan(Of Byte), Optional options As JsonSerializerOptions = Nothing) As TValue
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

Представление TValue данного значения JSON.

Исключения

Недопустимый JSON.

-или-

TValue несовместим с JSON.

-или-

Остались данные в диапазоне больше одного значения JSON.

Совместимые объекты JsonConverter для TValue или его сериализуемых членов отсутствуют.

Комментарии

Дополнительные сведения см. в разделе Сериализация и десериализация JSON.

Применяется к

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

Исходный код:
JsonSerializer.Read.Stream.cs
Исходный код:
JsonSerializer.Read.Stream.cs
Исходный код:
JsonSerializer.Read.Stream.cs

Считывает текст в кодировке UTF-8, представляющий одно значение JSON, в .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

Представление TValue данного значения JSON.

Исключения

Параметр utf8Json или jsonTypeInfo имеет значение null.

Json является недопустимым, TValue несовместим с JSON или есть оставшиеся данные в Stream.

Совместимые объекты JsonConverter для TValue или его сериализуемых членов отсутствуют.

Применяется к

Deserialize<TValue>(Stream, JsonSerializerOptions)

Исходный код:
JsonSerializer.Read.Stream.cs
Исходный код:
JsonSerializer.Read.Stream.cs
Исходный код:
JsonSerializer.Read.Stream.cs

Считывает текст в кодировке UTF-8, представляющий одно значение JSON, в .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

Представление TValue данного значения JSON.

Исключения

utf8Json имеет значение null.

Json является недопустимым, TValue несовместим с JSON или есть оставшиеся данные в Stream.

Совместимые объекты JsonConverter для TValue или его сериализуемых членов отсутствуют.

Применяется к

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

Исходный код:
JsonSerializer.Read.String.cs
Исходный код:
JsonSerializer.Read.String.cs
Исходный код:
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

Представление TValue данного значения JSON.

Исключения

json имеет значение null.

-или-

jsonTypeInfo имеет значение null.

Недопустимый JSON.

-или-

TValue несовместим с JSON.

-или-

Остались данные в строке больше одного значения JSON.

Совместимые объекты JsonConverter для TValue или его сериализуемых членов отсутствуют.

Комментарии

String Использование не так эффективно, как использование методов UTF-8, так как реализация изначально использует UTF-8.

Применяется к