JavaScriptSerializer.Deserialize Метод

  • Ссылка

Определение

Пространство имен:
System.Web.Script.Serialization
Сборка:
System.Web.Extensions.dll

Перегрузки

Deserialize(String, Type)

Преобразует строку формата JSON в объект заданного типа.
Deserialize<T>(String)

Преобразует указанную строку формата JSON в объект типа T.

Deserialize(String, Type)

Преобразует строку формата JSON в объект заданного типа.

public:
 System::Object ^ Deserialize(System::String ^ input, Type ^ targetType);
public object Deserialize (string input, Type targetType);
member this.Deserialize : string * Type -> obj
Public Function Deserialize (input As String, targetType As Type) As Object

Параметры

input
String

Десериализируемая строка JSON.

targetType
Type

Тип результирующего объекта.

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

Object

Десериализованный объект.

Исключения

ArgumentNullException

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

ArgumentException

Длина параметра input превышает значение свойства MaxJsonLength.

-или-

Превышено ограничение на рекурсию, заданное свойством RecursionLimit.

-или-

Параметр input содержит неизвестную последовательность символов.

-или-

Параметр input является типом словаря и при этом обнаружено значение ключа не строчного типа.

-или-

Параметр input содержит определения членов, которые недоступны для целевого типа.

InvalidOperationException

Параметр input содержит свойство "__type", которым обозначается пользовательский тип, однако распознавателю типов, связанному в данный момент с сериализатором, не удалось найти соответствующий управляемый тип.

-или-

Параметр input содержит свойство "__type", которым обозначается пользовательский тип, однако результат десериализации соответствующей строки формата JSON не удалось присвоить ожидаемому целевому типу.

-или-

Параметр input содержит свойство "__type", которым обозначается объект Object или тип, не поддерживающий создание экземпляров (например, абстрактный тип или интерфейс).

-или-

Предпринята попытка привести массив JSON к управляемому типу, относящемуся к классу массивов, использование которого в качестве целевого типа десериализации JSON не поддерживается.

-или-

Не удается привести параметр input к целевому типу.

Комментарии

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

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

Deserialize<T>(String)

Преобразует указанную строку формата JSON в объект типа T.

public:
generic <typename T>
 T Deserialize(System::String ^ input);
public T Deserialize<T> (string input);
member this.Deserialize : string -> 'T
Public Function Deserialize(Of T) (input As String) As T

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

T

Тип результирующего объекта.

Параметры

input
String

Строка формата JSON, подлежащая десериализации.

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

T

Десериализованный объект.

Исключения

ArgumentException

Длина параметра input превышает значение свойства MaxJsonLength.

-или-

Превышено ограничение на рекурсию, заданное свойством RecursionLimit.

-или-

Параметр input содержит неизвестную последовательность символов.

-или-

Параметр input является типом словаря и при этом обнаружено значение ключа не строчного типа.

-или-

Параметр input содержит определения членов, которые недоступны для типа T.

ArgumentNullException

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

InvalidOperationException

Параметр input содержит свойство __type, которым обозначается пользовательский тип, однако связанному с сериализатором распознавателю типов не удалось найти соответствующий управляемый тип.

-или-

Параметр input содержит свойство "__type", которым обозначается пользовательский тип, однако результат десериализации соответствующей строки формата JSON не удалось присвоить ожидаемому целевому типу.

-или-

Параметр input содержит свойство __type, которым обозначается объект Object или тип, не поддерживающий создание экземпляров (например, абстрактные типы или интерфейс).

-или-

Предпринята попытка привести массив JSON к управляемому типу, относящемуся к классу массивов, использование которого в качестве целевого типа десериализации JSON не поддерживается.

-или-

Не удается привести параметр input к типу T.

Примеры

В следующем примере показана простая иллюстрация сериализации и десериализации объектов данных.

using System;
using System.Collections.Generic;
using System.Web.UI;
using System.Web.Script.Serialization;

namespace ExampleApplication
{
    public partial class _Default : Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            var RegisteredUsers = new List<Person>();
            RegisteredUsers.Add(new Person() { PersonID = 1, Name = "Bryon Hetrick", Registered = true });
            RegisteredUsers.Add(new Person() { PersonID = 2, Name = "Nicole Wilcox", Registered = true });
            RegisteredUsers.Add(new Person() { PersonID = 3, Name = "Adrian Martinson", Registered = false });
            RegisteredUsers.Add(new Person() { PersonID = 4, Name = "Nora Osborn", Registered = false });

            var serializer = new JavaScriptSerializer();
            var serializedResult = serializer.Serialize(RegisteredUsers);
            // Produces string value of:
            // [
            //     {"PersonID":1,"Name":"Bryon Hetrick","Registered":true},
            //     {"PersonID":2,"Name":"Nicole Wilcox","Registered":true},
            //     {"PersonID":3,"Name":"Adrian Martinson","Registered":false},
            //     {"PersonID":4,"Name":"Nora Osborn","Registered":false}
            // ]

            var deserializedResult = serializer.Deserialize<List<Person>>(serializedResult);
            // Produces List with 4 Person objects
        }
    }
}

Imports System.Web.Script.Serialization

Public Class _Default
    Inherits Page

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
        Dim RegisteredUsers As New List(Of Person)()
        RegisteredUsers.Add(New Person With {.PersonID = 1, .Name = "Bryon Hetrick", .Registered = True})
        RegisteredUsers.Add(New Person With {.PersonID = 2, .Name = "Nicole Wilcox", .Registered = True})
        RegisteredUsers.Add(New Person With {.PersonID = 3, .Name = "Adrian Martinson", .Registered = False})
        RegisteredUsers.Add(New Person With {.PersonID = 4, .Name = "Nora Osborn", .Registered = False})

        Dim serializer As New JavaScriptSerializer()
        Dim serializedResult = serializer.Serialize(RegisteredUsers)
        ' Produces string value of:
        ' [
        '     {"PersonID":1,"Name":"Bryon Hetrick","Registered":true},
        '     {"PersonID":2,"Name":"Nicole Wilcox","Registered":true},
        '     {"PersonID":3,"Name":"Adrian Martinson","Registered":false},
        '     {"PersonID":4,"Name":"Nora Osborn","Registered":false}
        ' ]

        Dim deserializedResult = serializer.Deserialize(Of List(Of Person))(serializedResult)
        ' Produces List with 4 Person objects
    End Sub
End Class

Для этого требуется класс с именем Person, как показано в следующем примере.

namespace ExampleApplication
{
    public class Person
    {
        public int PersonID { get; set; }
        public string Name { get; set; }
        public bool Registered { get; set; }
    }
}

Public Class Person
    Public Property PersonID As Integer
    Public Property Name As String
    Public Property Registered As Boolean
End Class

Комментарии

Метод Deserialize эквивалентен использованию метода для DeserializeObject получения графа объекта, а затем попытке привести результат к типу T.

Во время десериализации ссылается текущий сопоставитель типов сериализатора, который определяет управляемый тип, используемый при преобразовании элементов, вложенных в массивы и типы словаря. В результате процесс десериализации выполняет итерацию по всем вложенным элементам input. Дополнительные сведения о сопоставителях типов см. в JavaScriptTypeResolver разделе класс .

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