Partager via

JavaScriptSerializer.Deserialize Méthode

  • Référence

Définition

Espace de noms:
System.Web.Script.Serialization
Assembly:
System.Web.Extensions.dll

Surcharges

Deserialize(String, Type)

Convertit une chaîne JSON en objet du type spécifié.
Deserialize<T>(String)

Convertit la chaîne JSON spécifiée en objet de type T.

Deserialize(String, Type)

Convertit une chaîne JSON en objet du type spécifié.

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

Paramètres

input
String

Chaîne JSON à désérialiser.

targetType
Type

Type d'objet obtenu.

Retours

Object

L'objet désérialisé.

Exceptions

ArgumentNullException

input a la valeur null.

ArgumentException

La longueur de input excède la valeur de MaxJsonLength.

- ou -

La limite de récurrence définie par RecursionLimit a été dépassée.

- ou -

input contient une séquence de caractères inattendue.

- ou -

input est un type de dictionnaire et une valeur de clé autre qu'une chaîne a été rencontrée.

- ou -

input inclut des définitions de membre non disponibles sur le type cible.

InvalidOperationException

input contient une propriété « __type » qui indique un type personnalisé, mais le programme de résolution de type actuellement associé au sérialiseur ne trouve pas de type managé correspondant.

- ou -

input contient une propriété « __type » qui indique un type personnalisé, mais le résultat de la désérialisation de la chaîne JSON correspondante ne peut pas être assigné au type de cible attendu.

- ou -

input contient une propriété « __type » qui indique soit Object soit un type ne pouvant être instancié (par exemple, un type abstrait ou une interface).

- ou -

Une tentative a été faite pour convertir un tableau JSON en un type managé comme tableau non pris en charge pour une utilisation comme cible de désérialisation JSON.

- ou -

Il est impossible de convertir input vers le type cible.

Remarques

Cette méthode de désérialisation n’essaie pas de caster la racine du graphique d’objets vers un type spécifique, comme la méthode le Deserialize fait.

S’applique à

Deserialize<T>(String)

Convertit la chaîne JSON spécifiée en objet de type 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

Paramètres de type

T

Type d'objet obtenu.

Paramètres

input
String

Chaîne JSON à désérialiser.

Retours

T

L'objet désérialisé.

Exceptions

ArgumentException

La longueur de input excède la valeur de MaxJsonLength.

- ou -

La limite de récurrence définie par RecursionLimit a été dépassée.

- ou -

input contient une séquence de caractères inattendue.

- ou -

input est un type de dictionnaire et une valeur de clé autre qu'une chaîne a été rencontrée.

- ou -

input inclut des définitions de membre non disponibles sur le type T.

ArgumentNullException

input a la valeur null.

InvalidOperationException

input contient une propriété "__type" qui indique un type personnalisé, mais le programme de résolution de type associé au sérialiseur ne trouve pas de type managé correspondant.

- ou -

input contient une propriété « __type » qui indique un type personnalisé, mais le résultat de la désérialisation de la chaîne JSON correspondante ne peut pas être assigné au type de cible attendu.

- ou -

input contient une propriété "__type" qui indique soit Object soit un type ne pouvant être instancié (par exemple, un type abstrait ou une interface).

- ou -

Une tentative a été faite pour convertir un tableau JSON en un type managé comme tableau non pris en charge pour une utilisation comme cible de désérialisation JSON.

- ou -

Il n'est pas possible de convertir input en T.

Exemples

L’exemple suivant fournit une illustration simple de la sérialisation et de la désérialisation des objets de données.

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

Elle nécessite une classe nommée Person, qui est illustrée dans l’exemple suivant.

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

Remarques

La Deserialize méthode équivaut à utiliser d’abord la DeserializeObject méthode pour obtenir un graphique d’objet, puis à essayer de convertir le résultat en type T.

Pendant la désérialisation, le programme de résolution de type actuel du sérialiseur est référencé, ce qui détermine le type managé à utiliser lors de la conversion d’éléments imbriqués dans des tableaux et des types de dictionnaire. Par conséquent, le processus de désérialisation itère au sein de tous les éléments imbriqués de input. Pour plus d’informations sur les résolveurs de type, consultez la JavaScriptTypeResolver classe .

S’applique à