JavaScriptSerializer.Serialize Méthode

Définition

Espace de noms:

System.Web.Script.Serialization

Assembly:

System.Web.Extensions.dll

Convertit un objet en chaîne JSON.

Surcharges

Nom	Description
Serialize(Object)	Convertit un objet en chaîne JSON.
Serialize(Object, StringBuilder)	Sérialise un objet et écrit la chaîne JSON obtenue dans l’objet spécifié StringBuilder .

Serialize(Object)

Convertit un objet en chaîne 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

Paramètres

obj

Object

Objet à sérialiser.

Retours

String

Chaîne JSON sérialisée.

Exceptions

InvalidOperationException

La chaîne JSON résultante dépasse la valeur de MaxJsonLength.

-ou-

obj contient une référence circulaire. Une référence circulaire se produit lorsqu’un objet enfant a une référence à un objet parent et que l’objet parent a une référence à l’objet enfant.

ArgumentException

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

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

Lorsque l’instance JavaScriptSerializer sérialise un type pour lequel un convertisseur personnalisé est inscrit, le sérialiseur appelle la Serialize méthode pour obtenir le dictionnaire de paires nom/valeur qui seront converties en chaîne JSON.

La Serialize méthode peut également lever des exceptions si le graphique d’objet est trop complexe ou si des instances inscrites ont JavaScriptConverter provoqué la récursivité du convertisseur.

Serialize(Object, StringBuilder)

Sérialise un objet et écrit la chaîne JSON obtenue dans l’objet spécifié 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)

Paramètres

obj

Object

Objet à sérialiser.

output

StringBuilder

Objet StringBuilder utilisé pour écrire la chaîne JSON.

Exceptions

InvalidOperationException

La chaîne JSON résultante dépasse la valeur de MaxJsonLength.

-ou-

obj contient une référence circulaire. Une référence circulaire se produit lorsqu’un objet enfant a une référence à un objet parent et que l’objet parent a une référence à l’objet enfant.

ArgumentException

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

ArgumentNullException

output a la valeur null.

Remarques

Lorsque l’instance JavaScriptSerializer sérialise un type pour lequel un convertisseur personnalisé est inscrit, le sérialiseur appelle la Serialize méthode pour obtenir le dictionnaire de paires nom/valeur qui seront converties en chaîne JSON.

La Serialize méthode peut également lever des exceptions si le graphique d’objet est trop complexe ou si des instances inscrites ont JavaScriptConverter provoqué la récursivité du convertisseur.