JsonSerializer.Deserialize Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
Deserialize(Stream, JsonTypeInfo) |
Считывает текст в кодировке UTF-8, представляющий одно значение JSON, в экземпляр, указанный в |
Deserialize(Utf8JsonReader, Type, JsonSerializerContext) |
Считывает одно значение JSON (включая объекты или массивы) из предоставленного средства чтения в |
Deserialize(Utf8JsonReader, Type, JsonSerializerOptions) |
Считывает одно значение JSON (включая объекты или массивы) из предоставленного средства чтения и преобразует его в экземпляр указанного типа. |
Deserialize(JsonNode, Type, JsonSerializerOptions) |
Преобразует объект , JsonNode представляющий одно значение JSON, в . |
Deserialize(JsonElement, Type, JsonSerializerContext) |
Преобразует объект , JsonElement представляющий одно значение JSON, в . |
Deserialize(JsonElement, Type, JsonSerializerOptions) |
Преобразует объект , JsonElement представляющий одно значение JSON, в . |
Deserialize(JsonDocument, Type, JsonSerializerContext) |
Преобразует объект , JsonDocument представляющий одно значение JSON, в . |
Deserialize(JsonDocument, Type, JsonSerializerOptions) |
Преобразует объект , JsonDocument представляющий одно значение JSON, в . |
Deserialize(String, Type, JsonSerializerContext) |
Анализирует текст, представляющий одно значение JSON, в . |
Deserialize(String, Type, JsonSerializerOptions) |
Выполняет синтаксический анализ текста, представляющего одно значение JSON, в экземпляр указанного типа. |
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerContext) |
Анализирует текст, представляющий одно значение JSON, в . |
Deserialize(ReadOnlySpan<Char>, Type, JsonSerializerOptions) |
Выполняет синтаксический анализ текста, представляющего одно значение JSON, в экземпляр указанного типа. |
Deserialize(JsonNode, Type, JsonSerializerContext) |
Преобразует объект , JsonNode представляющий одно значение JSON, в . |
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerOptions) |
Выполняет синтаксический анализ текста в кодировке UTF-8, представляющего одно значение JSON, в экземпляр указанного типа. |
Deserialize(ReadOnlySpan<Byte>, Type, JsonSerializerContext) |
Анализирует текст в кодировке UTF-8, представляющий одно значение JSON, в . |
Deserialize(ReadOnlySpan<Byte>, JsonTypeInfo) |
Анализирует текст в кодировке UTF-8, представляющий одно значение JSON, в экземпляр, указанный в |
Deserialize(String, JsonTypeInfo) |
Анализирует текст, представляющий одно значение JSON, в экземпляр, указанный в |
Deserialize(JsonDocument, JsonTypeInfo) |
Преобразует объект , JsonDocument представляющий одно значение JSON, в экземпляр, заданный . |
Deserialize(ReadOnlySpan<Char>, JsonTypeInfo) |
Анализирует текст, представляющий одно значение JSON, в экземпляр, указанный в |
Deserialize(JsonNode, JsonTypeInfo) |
Преобразует объект , JsonNode представляющий одно значение JSON, в экземпляр, заданный . |
Deserialize(Utf8JsonReader, JsonTypeInfo) |
Считывает одно значение JSON (включая объекты или массивы) из предоставленного средства чтения в экземпляр, заданный |
Deserialize(Stream, Type, JsonSerializerOptions) |
Считывает текст в кодировке UTF-8, представляющий одно значение JSON, в . |
Deserialize(Stream, Type, JsonSerializerContext) |
Считывает текст в кодировке UTF-8, представляющий одно значение JSON, в . |
Deserialize(JsonElement, JsonTypeInfo) |
Преобразует объект , JsonElement представляющий одно значение JSON, в экземпляр, заданный . |
Deserialize<TValue>(Utf8JsonReader, JsonTypeInfo<TValue>) |
Считывает одно значение JSON (включая объекты или массивы) из предоставленного средства чтения в |
Deserialize<TValue>(JsonDocument, JsonTypeInfo<TValue>) |
Преобразует объект , JsonDocument представляющий одно значение JSON, в . |
Deserialize<TValue>(Utf8JsonReader, JsonSerializerOptions) |
Считывает одно значение JSON (включая объекты или массивы) из предоставленного модуля чтения в экземпляр типа, заданного параметром универсального типа. |
Deserialize<TValue>(JsonNode, JsonTypeInfo<TValue>) |
Преобразует объект , JsonNode представляющий одно значение JSON, в . |
Deserialize<TValue>(JsonNode, JsonSerializerOptions) |
Преобразует объект , JsonNode представляющий одно значение JSON, в . |
Deserialize<TValue>(JsonElement, JsonTypeInfo<TValue>) |
Преобразует объект , JsonElement представляющий одно значение JSON, в . |
Deserialize<TValue>(JsonElement, JsonSerializerOptions) |
Преобразует объект , JsonElement представляющий одно значение JSON, в . |
Deserialize<TValue>(JsonDocument, JsonSerializerOptions) |
Преобразует объект , JsonDocument представляющий одно значение JSON, в . |
Deserialize<TValue>(ReadOnlySpan<Char>, JsonSerializerOptions) |
Выполняет синтаксический анализ текста, представляющего одно значение JSON, в экземпляр типа, заданного параметром универсального типа. |
Deserialize<TValue>(String, JsonSerializerOptions) |
Выполняет синтаксический анализ текста, представляющего одно значение JSON, в экземпляр типа, заданного параметром универсального типа. |
Deserialize<TValue>(ReadOnlySpan<Char>, JsonTypeInfo<TValue>) |
Анализирует текст, представляющий одно значение JSON, в . |
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonTypeInfo<TValue>) |
Анализирует текст в кодировке UTF-8, представляющий одно значение JSON, в . |
Deserialize<TValue>(ReadOnlySpan<Byte>, JsonSerializerOptions) |
Выполняет синтаксический анализ текста в кодировке UTF-8, представляющего одно значение JSON, в экземпляр типа, заданного параметром универсального типа. |
Deserialize<TValue>(Stream, JsonTypeInfo<TValue>) |
Считывает текст в кодировке UTF-8, представляющий одно значение JSON, в . |
Deserialize<TValue>(Stream, JsonSerializerOptions) |
Считывает текст в кодировке UTF-8, представляющий одно значение JSON, в . |
Deserialize<TValue>(String, JsonTypeInfo<TValue>) |
Анализирует текст, представляющий одно значение JSON, в . |
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
Параметры
- 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.
Исключения
Недопустимый 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
Параметры
- returnType
- Type
Тип объекта для преобразования и возврата.
- context
- JsonSerializerContext
Поставщик метаданных для сериализуемых типов.
Возвращаемое значение
Представление returnType
данного значения JSON.
Исключения
Недопустимый 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.
Исключения
Комментарии
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.
Исключения
Применяется к
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
.
Комментарии
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
Параметры
- 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
данного значения 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
данного значения JSON.
Исключения
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
данного значения 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.
Параметры
- jsonTypeInfo
- JsonTypeInfo<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.
Параметры
- options
- JsonSerializerOptions
Параметры для управления поведением во время анализа.
Возвращаемое значение
Представление 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
данного значения 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
данного значения 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
данного значения 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
данного значения 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
данного значения 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
данного значения JSON.
Исключения
Недопустимый 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
данного значения 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
данного значения 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
данного значения 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
данного значения 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
данного значения JSON.
Исключения
Недопустимый JSON.
-или-
TValue
несовместим с JSON.
-или-
Остались данные в строке больше одного значения JSON.
Совместимые объекты JsonConverter для TValue
или его сериализуемых членов отсутствуют.
Комментарии
String Использование не так эффективно, как использование методов UTF-8, так как реализация изначально использует UTF-8.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по