JavaScriptSerializer.Deserialize Méthode

Définition

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

Surcharges

Nom Description
Deserialize(String, Type)

Convertit une chaîne au format 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 au format 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 de l’objet résultant.

Retours

Object

Objet désérialisé.

Exceptions

ArgumentNullException

input a la valeur null.

ArgumentException

La longueur de input dépassement de la valeur de MaxJsonLength.

-ou-

La limite de récursivité 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é non-chaîne a été rencontrée.

-ou-

input inclut des définitions de membres qui ne sont pas 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 peut pas trouver un 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 affecté au type cible attendu.

-ou-

input contient une propriété « __type » qui indique soit Object un type non instanciable (par exemple, un type abstrait ou une interface).

-ou-

Une tentative a été effectuée pour convertir un tableau JSON en type managé de type tableau qui n’est pas pris en charge pour une utilisation comme cible de désérialisation JSON.

-ou-

Il n’est pas possible de convertir input en type cible.

Remarques

Cette méthode de désérialisation n’essaie pas de convertir la racine du graphique d’objet en un type spécifique, de la façon dont la Deserialize méthode effectue.

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 de l’objet résultant.

Paramètres

input
String

Chaîne JSON à désérialiser.

Retours

T

Objet désérialisé.

Exceptions

ArgumentException

La input longueur dépasse la valeur de MaxJsonLength.

-ou-

La limite de récursivité 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é non-chaîne a été rencontrée.

-ou-

input inclut des définitions de membres qui ne sont pas 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 peut pas trouver un 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 affecté au type cible attendu.

-ou-

input contient une propriété « __type » qui indique soit Object un type non instanciable (par exemple, un type abstrait ou une interface).

-ou-

Une tentative a été effectuée pour convertir un tableau JSON en type managé de type tableau qui n’est pas 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 d’abord à utiliser 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 effectue une itération au sein de tous les éléments imbriqués de input. Pour plus d’informations sur les résolveurs de types, consultez la JavaScriptTypeResolver classe.

S’applique à