JavaScriptSerializer.Deserialize Metoda

Definice

Obor názvů:
System.Web.Script.Serialization
Sestavení:
System.Web.Extensions.dll

Přetížení

Name Description
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 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 input překračuje hodnotu MaxJsonLength.

nebo

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

nebo

input obsahuje neočekávanou posloupnost znaků.

nebo

input je typ slovníku a byla zjištěna hodnota klíče bez řetězce.

nebo

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

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 buď Object nebo ne okamžitě realizovatelný typ (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 nepokouší přetypovat kořen grafu objektu na určitý typ, způsobem, jakým metoda Deserialize dělá.

Platí pro

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ý RecursionLimit pomocí.

nebo

input obsahuje neočekávanou posloupnost znaků.

nebo

input je typ slovníku a byla zjištěna hodnota klíče bez řetězce.

nebo

input obsahuje definice členů, které nejsou k dispozici pro typ 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 buď Object nebo ne okamžitě realizovatelný 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 zobrazena 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 ekvivalentní nejprve pomocí DeserializeObject metody získat objektový graf a pak se snaží přetypovat výsledek na typ T.

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

Platí pro