JavaScriptSerializer.Deserialize Metoda

Definice

Obor názvů:

System.Web.Script.Serialization

Sestavení:

System.Web.Extensions.dll

Přetížení

Deserialize(String, Type)	Převede řetězec ve formátu JSON na objekt zadaného typu.
Deserialize<T>(String)	Převede zadaný řetězec JSON na objekt typu T.

Deserialize(String, Type)

Převede řetězec ve formátu JSON na objekt zadaného typu.

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

Parametry

input

String

Řetězec formátu JSON, který se má deserializovat

targetType

Type

Typ výsledného objektu.

Návraty

Object

Deserializovaný objekt

Výjimky

ArgumentNullException

input je null.

ArgumentException

Délka parametru input překračuje hodnotu MaxJsonLength.

-nebo-

Byl překročen limit rekurze definovaný pomocí RecursionLimit .

-nebo-

input obsahuje neočekávanou posloupnost znaků.

-nebo-

input je typ slovníku a byla zjištěna hodnota klíče, která není řetězcová.

-nebo-

input obsahuje definice členů, které nejsou k dispozici u cílového typu.

InvalidOperationException

input obsahuje vlastnost "__type", která označuje vlastní typ, ale překladač typů, který je aktuálně přidružen k serializátoru, nemůže najít odpovídající spravovaný typ.

-nebo-

input obsahuje vlastnost "__type", která označuje vlastní typ, ale výsledek deserializace odpovídajícího řetězce JSON nelze přiřadit očekávanému cílovému typu.

-nebo-

input obsahuje vlastnost "__type", která označuje typ Object nebo typ, který nelze vytvořit (například abstraktní typ nebo rozhraní).

-nebo-

Došlo k pokusu o převod pole JSON na spravovaný typ podobný poli, který není podporován pro použití jako cíl deserializace JSON.

-nebo-

Není možné převést input na cílový typ.

Poznámky

Tato metoda deserializace se nepokusí přetypovat kořen grafu objektů na konkrétní typ, jak Deserialize to dělá metoda.

Deserialize<T>(String)

Převede zadaný řetězec JSON na objekt typu 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

Parametry typu

T

Typ výsledného objektu.

Parametry

input

String

Řetězec JSON, který se má deserializovat.

Návraty

T

Deserializovaný objekt

Výjimky

ArgumentException

Délka input překračuje hodnotu MaxJsonLength.

-nebo-

Byl překročen limit rekurze definovaný pomocí RecursionLimit .

-nebo-

input obsahuje neočekávanou posloupnost znaků.

-nebo-

input je typ slovníku a byla zjištěna hodnota klíče, která není řetězcová.

-nebo-

input obsahuje definice členů, které nejsou k dispozici u typu T.

ArgumentNullException

input je null.

InvalidOperationException

input obsahuje vlastnost "__type", která označuje vlastní typ, ale překladač typů přidružený k serializátoru nemůže najít odpovídající spravovaný typ.

-nebo-

input obsahuje vlastnost "__type", která označuje vlastní typ, ale výsledek deserializace odpovídajícího řetězce JSON nelze přiřadit očekávanému cílovému typu.

-nebo-

input obsahuje vlastnost "__type", která označuje typ Object nebo ne instantní typ (například abstraktní typy nebo rozhraní).

-nebo-

Došlo k pokusu o převod pole JSON na spravovaný typ podobný poli, který není podporován pro použití jako cíl deserializace JSON.

-nebo-

Není možné převést input na T.

Příklady

Následující příklad poskytuje jednoduchou ilustraci, jak serializovat a deserializovat datové objekty.

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

Vyžaduje třídu s názvem Person, která je znázorněna v následujícím příkladu.

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

Poznámky

Metoda Deserialize je ekvivalentem prvního použití DeserializeObject metody k získání grafu objektů a následnému pokusu o přetypování výsledku na typ T.

Během deserializace se odkazuje na aktuální překladač typů serializátoru, který určuje spravovaný typ, který se má použít při převodu prvků, které jsou vnořené uvnitř polí a slovníkových typů. V důsledku toho proces deserializace iteruje všemi vnořenými prvky objektu input. Další informace o překladači typů najdete v JavaScriptTypeResolver této třídě.