JavaScriptSerializer.Serialize 메서드

정의

네임스페이스:
System.Web.Script.Serialization
어셈블리:
System.Web.Extensions.dll

개체를 JSON 문자열로 변환합니다.

오버로드

Name Description
Serialize(Object)

개체를 JSON 문자열로 변환합니다.
Serialize(Object, StringBuilder)

개체를 직렬화하고 결과 JSON 문자열을 지정된 StringBuilder 개체에 씁니다.

Serialize(Object)

개체를 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

매개 변수

obj
Object

serialize할 개체입니다.

반품

String

serialize된 JSON 문자열입니다.

예외

InvalidOperationException

결과 JSON 문자열이 .의 MaxJsonLength값을 초과합니다.

-또는-

obj 에는 순환 참조가 포함되어 있습니다. 자식 개체에 부모 개체에 대한 참조가 있고 부모 개체에 자식 개체에 대한 참조가 있는 경우 순환 참조가 발생합니다.

ArgumentException

정의된 RecursionLimit 재귀 제한을 초과했습니다.

예제

다음 예제에서는 데이터 개체를 직렬화하고 역직렬화하는 방법에 대한 간단한 그림을 제공합니다.

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

다음 예제와 같이 이름이 지정된 Person클래스가 필요합니다.

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

설명

인스턴스가 JavaScriptSerializer 사용자 지정 변환기가 등록된 형식을 serialize하는 경우 serializer는 메서드를 호출 Serialize 하여 JSON 문자열로 변환될 이름/값 쌍의 사전을 가져옵니다.

개체 그래프가 Serialize 너무 복잡하거나 등록된 인스턴스 JavaScriptConverter 가 변환기 재귀를 발생시킨 경우에도 메서드가 예외를 throw할 수 있습니다.

적용 대상

Serialize(Object, StringBuilder)

개체를 직렬화하고 결과 JSON 문자열을 지정된 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)

매개 변수

obj
Object

serialize할 개체입니다.

output
StringBuilder

StringBuilder JSON 문자열을 작성하는 데 사용되는 개체입니다.

예외

InvalidOperationException

결과 JSON 문자열이 .의 MaxJsonLength값을 초과합니다.

-또는-

obj 에는 순환 참조가 포함되어 있습니다. 자식 개체에 부모 개체에 대한 참조가 있고 부모 개체에 자식 개체에 대한 참조가 있는 경우 순환 참조가 발생합니다.

ArgumentException

정의된 RecursionLimit 재귀 제한을 초과했습니다.

ArgumentNullException

output은 null입니다.

설명

인스턴스가 JavaScriptSerializer 사용자 지정 변환기가 등록된 형식을 serialize하는 경우 serializer는 메서드를 호출 Serialize 하여 JSON 문자열로 변환될 이름/값 쌍의 사전을 가져옵니다.

개체 그래프가 Serialize 너무 복잡하거나 등록된 인스턴스 JavaScriptConverter 가 변환기 재귀를 발생시킨 경우에도 메서드가 예외를 throw할 수 있습니다.

적용 대상