JavaScriptSerializer.Serialize メソッド

定義

名前空間:

System.Web.Script.Serialization

アセンブリ:

System.Web.Extensions.dll

オブジェクトを JSON 文字列に変換します。

オーバーロード

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

シリアル化するオブジェクト。

戻り値

String

シリアル化された 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 呼び出して、JSON 文字列に変換される名前と値のペアのディクショナリを取得します。

メソッドは Serialize 、オブジェクト グラフが複雑すぎる場合や、 の登録済みインスタンスがコンバーター再帰を JavaScriptConverter 引き起こした場合にも例外をスローできます。

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

シリアル化するオブジェクト。

output

StringBuilder

JSON 文字列を書き込むために使用される StringBuilder オブジェクト。

例外

InvalidOperationException

生成される JSON 文字列が、MaxJsonLength 値を超えています。

- または -

obj に循環参照が含まれています。 循環参照は、子オブジェクトが親オブジェクトへの参照を持ち、親オブジェクトがその子オブジェクトへの参照を持つ場合に発生します。

ArgumentException

RecursionLimit で定義された再帰制限を超えています。

ArgumentNullException

output が nullです。

注釈

カスタム コンバーターが JavaScriptSerializer 登録されている型をインスタンスがシリアル化している場合、シリアライザーは メソッドを Serialize 呼び出して、JSON 文字列に変換される名前と値のペアのディクショナリを取得します。

メソッドは Serialize 、オブジェクト グラフが複雑すぎる場合や、 の登録済みインスタンスがコンバーター再帰を JavaScriptConverter 引き起こした場合にも例外をスローできます。