Share via

JavaScriptSerializer.Deserialize Método

  • Referencia

Definición

Espacio de nombres:
System.Web.Script.Serialization
Ensamblado:
System.Web.Extensions.dll

Sobrecargas

Deserialize(String, Type)

Convierte una cadena con formato JSON en un objeto del tipo especificado.
Deserialize<T>(String)

Convierte la cadena JSON especificada en un objeto de tipo T.

Deserialize(String, Type)

Convierte una cadena con formato JSON en un objeto del tipo especificado.

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

Parámetros

input
String

Cadena JSON que se va a deserializar.

targetType
Type

Tipo del objeto resultante.

Devoluciones

Object

Objeto deserializado.

Excepciones

ArgumentNullException

input es null.

ArgumentException

La longitud de input es superior al valor de MaxJsonLength.

o bien

Se superó el límite de recursividad definido por RecursionLimit.

o bien

input contiene una secuencia de caracteres inesperada.

o bien

input es un tipo de diccionario y se encontró un valor de clave que no es de cadena.

o bien

input incluye definiciones de miembros que no están disponibles en el tipo de destino.

InvalidOperationException

input contiene una propiedad "__type" que indica un tipo personalizado, pero la resolución de tipos que está asociada actualmente al serializador no puede encontrar un tipo administrado correspondiente.

o bien

input contiene una propiedad "__type" que indica un tipo personalizado, pero el resultado de deserializar la cadena JSON correspondiente no puede asignarse al tipo de destino esperado.

o bien

input contiene una propiedad "__type" que indica Object o un tipo del que no se pueden crear instancias (por ejemplo, un tipo abstracto o una interfaz).

o bien

Se intentó convertir una matriz JSON en un tipo administrado a modo de matriz que no se puede usar como destino de deserialización de JSON.

o bien

No se puede convertir input al tipo de destino.

Comentarios

Este método de deserialización no intenta convertir la raíz del gráfico de objetos en un tipo específico, como hace el Deserialize método.

Se aplica a

Deserialize<T>(String)

Convierte la cadena JSON especificada en un objeto de tipo 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

Parámetros de tipo

T

Tipo del objeto resultante.

Parámetros

input
String

Cadena JSON que se va a deserializar.

Devoluciones

T

Objeto deserializado.

Excepciones

ArgumentException

La longitud de input es superior al valor de MaxJsonLength.

o bien

Se superó el límite de recursividad definido por RecursionLimit.

o bien

input contiene una secuencia de caracteres inesperada.

o bien

input es un tipo de diccionario y se encontró un valor de clave que no es de cadena.

o bien

input incluye definiciones de miembro que no están disponibles en el tipo T.

ArgumentNullException

input es null.

InvalidOperationException

input contiene una propiedad "__type" que indica un tipo personalizado, pero la resolución de tipos que está asociada al serializador no puede encontrar un tipo administrado correspondiente.

o bien

input contiene una propiedad "__type" que indica un tipo personalizado, pero el resultado de deserializar la cadena JSON correspondiente no puede asignarse al tipo de destino esperado.

o bien

input contiene una propiedad "__type" que indica Object o un tipo del que no se pueden crear instancias (por ejemplo, un tipo abstracto o una interfaz).

o bien

Se intentó convertir una matriz JSON en un tipo administrado a modo de matriz que no se puede usar como destino de deserialización de JSON.

o bien

No es posible convertir input en T.

Ejemplos

En el ejemplo siguiente se proporciona una ilustración sencilla de cómo serializar y deserializar objetos de datos.

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

Requiere una clase denominada Person, que se muestra en el ejemplo siguiente.

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

Comentarios

El Deserialize método es equivalente a usar primero el DeserializeObject método para obtener un gráfico de objetos y, a continuación, intentar convertir el resultado en el tipo T.

Durante la deserialización, se hace referencia a la resolución de tipos actual del serializador, que determina el tipo administrado que se va a usar al convertir elementos anidados dentro de matrices y tipos de diccionario. Como resultado, el proceso de deserialización recorre en iteración todos los elementos anidados de input. Para obtener más información sobre los solucionadores de tipos, vea la JavaScriptTypeResolver clase .

Se aplica a