JavaScriptSerializer.Serialize Metoda

Definice

Obor názvů:

System.Web.Script.Serialization

Sestavení:

System.Web.Extensions.dll

Převede objekt na řetězec JSON.

Přetížení

Serialize(Object)	Převede objekt na řetězec JSON.
Serialize(Object, StringBuilder)	Serializuje objekt a zapíše výsledný řetězec JSON do zadaného StringBuilder objektu.

Serialize(Object)

Převede objekt na řetězec 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

Parametry

obj

Object

Objekt, který se má serializovat.

Návraty

String

Serializovaný řetězec JSON.

Výjimky

InvalidOperationException

Výsledný řetězec JSON překračuje hodnotu MaxJsonLength.

-nebo- obj obsahuje cyklický odkaz. Cyklický odkaz nastane, když podřízený objekt má odkaz na nadřazený objekt a nadřazený objekt má odkaz na podřízený objekt.

ArgumentException

Byl překročen limit rekurze definovaný.RecursionLimit

Příklady

Následující příklad obsahuje jednoduchý obrázek, jak serializovat a deserializovat datové objekty.

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

Vyžaduje třídu s názvem Person, která je zobrazena v následujícím příkladu.

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

Poznámky

JavaScriptSerializer Když instance serializuje typ, pro který je registrován vlastní převaděč, serializátor volá Serialize metodu k získání slovníku párů name/value, které budou převedeny na řetězec JSON.

Metoda Serialize může také vyvolat výjimky, pokud je graf objektu příliš složitý nebo pokud registrované instance JavaScriptConverter způsobily rekurz převaděče.

Serialize(Object, StringBuilder)

Serializuje objekt a zapíše výsledný řetězec JSON do zadaného StringBuilder objektu.

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)

Parametry

obj

Object

Objekt, který se má serializovat.

output

StringBuilder

Objekt StringBuilder , který se používá k zápisu řetězce JSON.

Výjimky

InvalidOperationException

Výsledný řetězec JSON překračuje hodnotu MaxJsonLength.

-nebo- obj obsahuje cyklický odkaz. Cyklický odkaz nastane, když podřízený objekt má odkaz na nadřazený objekt a nadřazený objekt má odkaz na podřízený objekt.

ArgumentException

Byl překročen limit rekurze definovaný.RecursionLimit

ArgumentNullException

output je null.

Poznámky

JavaScriptSerializer Když instance serializuje typ, pro který je registrován vlastní převaděč, serializátor volá Serialize metodu k získání slovníku párů name/value, které budou převedeny na řetězec JSON.

Metoda Serialize může také vyvolat výjimky, pokud je graf objektu příliš složitý nebo pokud registrované instance JavaScriptConverter způsobily rekurz převaděče.