Share via

JavaScriptSerializer.Serialize Método

  • Referencia

Definición

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

Convierte un objeto en una cadena JSON.

Sobrecargas

Serialize(Object)

Convierte un objeto en una cadena JSON.
Serialize(Object, StringBuilder)

Serializa un objeto y escribe la cadena JSON resultante en el objeto StringBuilder especificado.

Serialize(Object)

Convierte un objeto en una cadena JSON.

public:
 System::String ^ Serialize(System::Object ^ obj);
public string Serialize (object obj);
member this.Serialize : obj -> string
Public Function Serialize (obj As Object) As String

Parámetros

obj
Object

El objeto que se va a serializar.

Devoluciones

String

Cadena JSON serializada.

Excepciones

InvalidOperationException

La cadena JSON resultante supera el valor de MaxJsonLength.

o bien

obj contiene una referencia circular. Una referencia circular ocurre cuando un objeto secundario hace referencia a un objeto primario, y el objeto primario tiene una referencia al objeto secundario.

ArgumentException

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

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

Cuando la JavaScriptSerializer instancia serializa un tipo para el que se registra un convertidor personalizado, el serializador llama al Serialize método para obtener el diccionario de pares nombre-valor que se convertirán en una cadena JSON.

El Serialize método también puede producir excepciones si el gráfico de objetos es demasiado complejo o si las instancias registradas de han provocado la recursividad del JavaScriptConverter convertidor.

Se aplica a

Serialize(Object, StringBuilder)

Serializa un objeto y escribe la cadena JSON resultante en el objeto StringBuilder especificado.

public:
 void Serialize(System::Object ^ obj, System::Text::StringBuilder ^ output);
public void Serialize (object obj, System.Text.StringBuilder output);
member this.Serialize : obj * System.Text.StringBuilder -> unit
Public Sub Serialize (obj As Object, output As StringBuilder)

Parámetros

obj
Object

El objeto que se va a serializar.

output
StringBuilder

Objeto StringBuilder que se usa para escribir la cadena JSON.

Excepciones

InvalidOperationException

La cadena JSON resultante supera el valor de MaxJsonLength.

o bien

obj contiene una referencia circular. Una referencia circular ocurre cuando un objeto secundario hace referencia a un objeto primario, y el objeto primario tiene una referencia al objeto secundario.

ArgumentException

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

ArgumentNullException

output es null.

Comentarios

Cuando la JavaScriptSerializer instancia serializa un tipo para el que se registra un convertidor personalizado, el serializador llama al Serialize método para obtener el diccionario de pares nombre-valor que se convertirán en una cadena JSON.

El Serialize método también puede producir excepciones si el gráfico de objetos es demasiado complejo o si las instancias registradas de han provocado la recursividad del JavaScriptConverter convertidor.

Se aplica a