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

Объект StringBuilder, используемый для записи строки формата JSON.

Исключения

InvalidOperationException

Результирующая строка формата JSON превышает значение свойства MaxJsonLength.

-или-

Параметр obj содержит циклическую ссылку. Циклическая ссылка возникает, если дочерний объект ссылается на родительский объект, а родительский объект ссылается на дочерний.

ArgumentException

Превышено ограничение на рекурсию, заданное свойством RecursionLimit.

ArgumentNullException

output имеет значение null.

Комментарии

JavaScriptSerializer Когда экземпляр сериализует тип, для которого зарегистрирован пользовательский преобразователь, сериализатор вызывает Serialize метод , чтобы получить словарь пар "имя-значение", который будет преобразован в строку JSON.

Метод Serialize также может создавать исключения, если граф объекта слишком сложен или если зарегистрированные экземпляры JavaScriptConverter вызвали рекурсию преобразователя.