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 классе.

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