JavaScriptSerializer.Serialize Yöntem

Tanım

Ad Alanı:

System.Web.Script.Serialization

Bütünleştirilmiş Kod:

System.Web.Extensions.dll

Nesneyi JSON dizesine dönüştürür.

Aşırı Yüklemeler

Serialize(Object)	Nesneyi JSON dizesine dönüştürür.
Serialize(Object, StringBuilder)	Bir nesneyi serileştirir ve sonuçta elde edilen JSON dizesini belirtilen StringBuilder nesneye yazar.

Serialize(Object)

Nesneyi JSON dizesine dönüştürür.

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

Parametreler

obj

Object

Serileştirecek nesne.

Döndürülenler

String

Serileştirilmiş JSON dizesi.

Özel durumlar

InvalidOperationException

Elde edilen JSON dizesi değerini MaxJsonLengthaşıyor.

-veya-

obj döngüsel başvuru içerir. Bir alt nesnenin üst nesneye başvurusu olduğunda ve üst nesnenin alt nesneye başvurusu olduğunda döngüsel başvuru oluşur.

ArgumentException

tarafından RecursionLimit tanımlanan özyineleme sınırı aşıldı.

Örnekler

Aşağıdaki örnek, veri nesnelerini seri hale getirme ve seri durumdan çıkarma işleminin basit bir çizimi sağlar.

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

Aşağıdaki örnekte gösterilen adlı Personbir sınıf gerektirir.

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

Açıklamalar

Örnek, özel bir dönüştürücü kaydedildiği JavaScriptSerializer bir türü serileştirirken, seri hale getirici JSON dizesine dönüştürülecek ad/değer çiftlerinin sözlüğünü almak için yöntemini çağırır Serialize .

Yöntem Serialize ayrıca nesne grafı çok karmaşıksa veya kayıtlı örnekleri JavaScriptConverter dönüştürücü özyinelemesine neden olmuşsa özel durumlar oluşturabilir.

Serialize(Object, StringBuilder)

Bir nesneyi serileştirir ve sonuçta elde edilen JSON dizesini belirtilen StringBuilder nesneye yazar.

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)

Parametreler

obj

Object

Serileştirecek nesne.

output

StringBuilder

StringBuilder JSON dizesini yazmak için kullanılan nesne.

Özel durumlar

InvalidOperationException

Elde edilen JSON dizesi değerini MaxJsonLengthaşıyor.

-veya-

obj döngüsel başvuru içerir. Bir alt nesnenin üst nesneye başvurusu olduğunda ve üst nesnenin alt nesneye başvurusu olduğunda döngüsel başvuru oluşur.

ArgumentException

tarafından RecursionLimit tanımlanan özyineleme sınırı aşıldı.

ArgumentNullException

output, null değeridir.

Açıklamalar

Örnek, özel bir dönüştürücü kaydedildiği JavaScriptSerializer bir türü serileştirirken, seri hale getirici JSON dizesine dönüştürülecek ad/değer çiftlerinin sözlüğünü almak için yöntemini çağırır Serialize .

Yöntem Serialize ayrıca nesne grafı çok karmaşıksa veya kayıtlı örnekleri JavaScriptConverter dönüştürücü özyinelemesine neden olmuşsa özel durumlar oluşturabilir.