JavaScriptSerializer.Serialize Metoda

Definicja

Przestrzeń nazw:

System.Web.Script.Serialization

Zestaw:

System.Web.Extensions.dll

Konwertuje obiekt na ciąg JSON.

Przeciążenia

Serialize(Object)	Konwertuje obiekt na ciąg JSON.
Serialize(Object, StringBuilder)	Serializuje obiekt i zapisuje wynikowy ciąg JSON do określonego StringBuilder obiektu.

Serialize(Object)

Konwertuje obiekt na ciąg 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

Obiekt do serializacji.

Zwraca

String

Serializowany ciąg JSON.

Wyjątki

InvalidOperationException

Wynikowy ciąg JSON przekracza wartość MaxJsonLength.

-lub-

obj zawiera odwołanie cykliczne. Odwołanie cykliczne występuje, gdy obiekt podrzędny ma odwołanie do obiektu nadrzędnego, a obiekt nadrzędny ma odwołanie do obiektu podrzędnego.

ArgumentException

Przekroczono limit rekursji zdefiniowany przez RecursionLimit .

Przykłady

Poniższy przykład przedstawia prostą ilustrację sposobu serializacji i deserializacji obiektów danych.

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

Wymaga klasy o nazwie Person, która jest wyświetlana w poniższym przykładzie.

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

Uwagi

Gdy JavaScriptSerializer wystąpienie serializuje typ, dla którego jest zarejestrowany konwerter niestandardowy, serializator wywołuje Serialize metodę w celu uzyskania słownika par nazw/wartości, które zostaną przekonwertowane na ciąg JSON.

Metoda Serialize może również zgłaszać wyjątki, jeśli wykres obiektu jest zbyt złożony lub jeśli zarejestrowane wystąpienia spowodowały rekursję JavaScriptConverter konwertera.

Serialize(Object, StringBuilder)

Serializuje obiekt i zapisuje wynikowy ciąg JSON do określonego StringBuilder obiektu.

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

Obiekt do serializacji.

output

StringBuilder

StringBuilder Obiekt używany do zapisywania ciągu JSON.

Wyjątki

InvalidOperationException

Wynikowy ciąg JSON przekracza wartość MaxJsonLength.

-lub-

obj zawiera odwołanie cykliczne. Odwołanie cykliczne występuje, gdy obiekt podrzędny ma odwołanie do obiektu nadrzędnego, a obiekt nadrzędny ma odwołanie do obiektu podrzędnego.

ArgumentException

Przekroczono limit rekursji zdefiniowany przez RecursionLimit .

ArgumentNullException

output to null.

Uwagi

Gdy JavaScriptSerializer wystąpienie serializuje typ, dla którego jest zarejestrowany konwerter niestandardowy, serializator wywołuje Serialize metodę w celu uzyskania słownika par nazw/wartości, które zostaną przekonwertowane na ciąg JSON.

Metoda Serialize może również zgłaszać wyjątki, jeśli wykres obiektu jest zbyt złożony lub jeśli zarejestrowane wystąpienia spowodowały rekursję JavaScriptConverter konwertera.