JavaScriptSerializer.Serialize JavaScriptSerializer.Serialize JavaScriptSerializer.Serialize JavaScriptSerializer.Serialize Method

Определение

Преобразует объект в строку формата JSON.Converts an object to a JSON string.

Перегрузки

Serialize(Object) Serialize(Object) Serialize(Object) Serialize(Object)

Преобразует объект в строку формата JSON.Converts an object to a JSON string.

Serialize(Object, StringBuilder) Serialize(Object, StringBuilder) Serialize(Object, StringBuilder) Serialize(Object, StringBuilder)

Сериализует объект и записывает результирующую строку формата JSON в указанный объект StringBuilder.Serializes an object and writes the resulting JSON string to the specified StringBuilder object.

Serialize(Object) Serialize(Object) Serialize(Object) Serialize(Object)

Преобразует объект в строку формата JSON.Converts an object to a JSON string.

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 Object Object Object

Объект для сериализации.The object to serialize.

Возвраты

Сериализованная строка формата JSON.The serialized JSON string.

Исключения

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

-или--or- Параметр obj содержит циклическую ссылку.obj contains a circular reference. Циклическая ссылка возникает, если дочерний объект ссылается на родительский объект, а родительский объект ссылается на дочерний.A circular reference occurs when a child object has a reference to a parent object, and the parent object has a reference to the child object.

Превышено ограничение на рекурсию, заданное свойством RecursionLimit.The recursion limit defined by RecursionLimit was exceeded.

Примеры

Следующий пример иллюстрирует это того, как сериализовывать и десериализовывать объекты данных.The following example provides a simple illustration of how to serialize and deserialize data objects.

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, как показано в следующем примере.It requires a class named Person, which is shown in the following example.

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.When the JavaScriptSerializer instance is serializing a type for which a custom converter is registered, the serializer calls the Serialize method to obtain the dictionary of name/value pairs that will be converted to a JSON string.

Serialize Метод также может выдавать исключения, если граф объекта является слишком сложным или зарегистрированные экземпляры JavaScriptConverter вызвали преобразователь рекурсии.The Serialize method can also throw exceptions if the object graph is too complex, or if registered instances of JavaScriptConverter have caused converter recursion.

Serialize(Object, StringBuilder) Serialize(Object, StringBuilder) Serialize(Object, StringBuilder) Serialize(Object, StringBuilder)

Сериализует объект и записывает результирующую строку формата JSON в указанный объект StringBuilder.Serializes an object and writes the resulting JSON string to the specified StringBuilder object.

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 Object Object Object

Объект для сериализации.The object to serialize.

output
StringBuilder StringBuilder StringBuilder StringBuilder

Объект StringBuilder, используемый для записи строки формата JSON.The StringBuilder object that is used to write the JSON string.

Исключения

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

-или--or- Параметр obj содержит циклическую ссылку.obj contains a circular reference. Циклическая ссылка возникает, если дочерний объект ссылается на родительский объект, а родительский объект ссылается на дочерний.A circular reference occurs when a child object has a reference to a parent object, and the parent object has a reference to the child object.

Превышено ограничение на рекурсию, заданное свойством RecursionLimit.The recursion limit defined by RecursionLimit was exceeded.

Комментарии

Когда JavaScriptSerializer экземпляра сериализации типа для которого регистрируется пользовательский преобразователь, вызовы сериализатор Serialize метод, чтобы получить словарь пар "имя значение", которые будут преобразованы в строку JSON.When the JavaScriptSerializer instance is serializing a type for which a custom converter is registered, the serializer calls the Serialize method to obtain the dictionary of name/value pairs that will be converted to a JSON string.

Serialize Метод также может выдавать исключения, если граф объекта является слишком сложным или зарегистрированные экземпляры JavaScriptConverter вызвали преобразователь рекурсии.The Serialize method can also throw exceptions if the object graph is too complex, or if registered instances of JavaScriptConverter have caused converter recursion.

Применяется к