JavaScriptSerializer.Serialize Metode

Definisi

Ruang nama:

System.Web.Script.Serialization

Rakitan:

System.Web.Extensions.dll

Mengonversi objek menjadi string JSON.

Overload

Nama	Deskripsi
Serialize(Object)	Mengonversi objek menjadi string JSON.
Serialize(Object, StringBuilder)	Menserialisasi objek dan menulis string JSON yang dihasilkan ke objek yang ditentukan StringBuilder .

Serialize(Object)

Mengonversi objek menjadi string 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

Parameter

obj

Object

Objek yang akan diserialisasikan.

Mengembalikan

String

String JSON yang diserialisasikan.

Pengecualian

InvalidOperationException

String JSON yang dihasilkan melebihi nilai MaxJsonLength.

-atau-

obj berisi referensi melingkar. Referensi melingkar terjadi ketika objek anak memiliki referensi ke objek induk, dan objek induk memiliki referensi ke objek anak.

ArgumentException

Batas rekursi yang ditentukan oleh RecursionLimit terlampaui.

Contoh

Contoh berikut memberikan ilustrasi sederhana tentang cara membuat serialisasi dan mendeserialisasi objek data.

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

Ini memerlukan kelas bernama Person, yang ditunjukkan dalam contoh berikut.

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

Keterangan

JavaScriptSerializer Ketika instans menserialisasikan Serialize jenis di mana pengonversi kustom terdaftar, serializer memanggil metode untuk mendapatkan kamus pasangan nama/nilai yang akan dikonversi ke string JSON.

Metode ini Serialize juga dapat melemparkan pengecualian jika grafik objek terlalu kompleks, atau jika instans JavaScriptConverter terdaftar telah menyebabkan rekursi konverter.

Serialize(Object, StringBuilder)

Menserialisasi objek dan menulis string JSON yang dihasilkan ke objek yang ditentukan 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)

Parameter

obj

Object

Objek yang akan diserialisasikan.

output

StringBuilder

Objek StringBuilder yang digunakan untuk menulis string JSON.

Pengecualian

InvalidOperationException

String JSON yang dihasilkan melebihi nilai MaxJsonLength.

-atau-

obj berisi referensi melingkar. Referensi melingkar terjadi ketika objek anak memiliki referensi ke objek induk, dan objek induk memiliki referensi ke objek anak.

ArgumentException

Batas rekursi yang ditentukan oleh RecursionLimit terlampaui.

ArgumentNullException

output adalah null.

Keterangan

JavaScriptSerializer Ketika instans menserialisasikan Serialize jenis di mana pengonversi kustom terdaftar, serializer memanggil metode untuk mendapatkan kamus pasangan nama/nilai yang akan dikonversi ke string JSON.

Metode ini Serialize juga dapat melemparkan pengecualian jika grafik objek terlalu kompleks, atau jika instans JavaScriptConverter terdaftar telah menyebabkan rekursi konverter.