JavaScriptSerializer.Serialize Metodo

Definizione

Spazio dei nomi:
System.Web.Script.Serialization
Assembly:
System.Web.Extensions.dll

Converte un oggetto in una stringa JSON.

Overload

Nome Descrizione
Serialize(Object)

Converte un oggetto in una stringa JSON.
Serialize(Object, StringBuilder)

Serializza un oggetto e scrive la stringa JSON risultante nell'oggetto specificato StringBuilder .

Serialize(Object)

Converte un oggetto in una stringa 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

Parametri

obj
Object

Oggetto da serializzare.

Valori restituiti

String

Stringa JSON serializzata.

Eccezioni

InvalidOperationException

La stringa JSON risultante supera il valore di MaxJsonLength.

oppure

obj contiene un riferimento circolare. Un riferimento circolare si verifica quando un oggetto figlio ha un riferimento a un oggetto padre e l'oggetto padre ha un riferimento all'oggetto figlio.

ArgumentException

È stato superato il limite di ricorsione definito da RecursionLimit .

Esempio

Nell'esempio seguente viene fornita una semplice illustrazione di come serializzare e deserializzare oggetti dati.

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

Richiede una classe denominata Person, illustrata nell'esempio seguente.

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

Commenti

Quando l'istanza JavaScriptSerializer serializza un tipo per cui viene registrato un convertitore personalizzato, il serializzatore chiama il Serialize metodo per ottenere il dizionario di coppie nome/valore che verranno convertite in una stringa JSON.

Il Serialize metodo può anche generare eccezioni se l'oggetto grafico è troppo complesso o se le istanze registrate di hanno causato la ricorsione del JavaScriptConverter convertitore.

Si applica a

Serialize(Object, StringBuilder)

Serializza un oggetto e scrive la stringa JSON risultante nell'oggetto specificato StringBuilder .

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)

Parametri

obj
Object

Oggetto da serializzare.

output
StringBuilder

Oggetto StringBuilder usato per scrivere la stringa JSON.

Eccezioni

InvalidOperationException

La stringa JSON risultante supera il valore di MaxJsonLength.

oppure

obj contiene un riferimento circolare. Un riferimento circolare si verifica quando un oggetto figlio ha un riferimento a un oggetto padre e l'oggetto padre ha un riferimento all'oggetto figlio.

ArgumentException

È stato superato il limite di ricorsione definito da RecursionLimit .

ArgumentNullException

output è null.

Commenti

Quando l'istanza JavaScriptSerializer serializza un tipo per cui viene registrato un convertitore personalizzato, il serializzatore chiama il Serialize metodo per ottenere il dizionario di coppie nome/valore che verranno convertite in una stringa JSON.

Il Serialize metodo può anche generare eccezioni se l'oggetto grafico è troppo complesso o se le istanze registrate di hanno causato la ricorsione del JavaScriptConverter convertitore.

Si applica a