JavaScriptSerializer.Serialize Metod

Definition

Namnområde:
System.Web.Script.Serialization
Sammansättning:
System.Web.Extensions.dll

Konverterar ett objekt till en JSON-sträng.

Överlagringar

Name Description
Serialize(Object)

Konverterar ett objekt till en JSON-sträng.
Serialize(Object, StringBuilder)

Serialiserar ett objekt och skriver den resulterande JSON-strängen till det angivna StringBuilder objektet.

Serialize(Object)

Konverterar ett objekt till en JSON-sträng.

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

Parametrar

obj
Object

Objektet som ska serialiseras.

Returer

String

Den serialiserade JSON-strängen.

Undantag

InvalidOperationException

Den resulterande JSON-strängen överskrider värdet MaxJsonLengthför .

-eller-

obj innehåller en cirkelreferens. En cirkelreferens inträffar när ett underordnat objekt har en referens till ett överordnat objekt och det överordnade objektet har en referens till det underordnade objektet.

ArgumentException

Rekursionsgränsen som definierades av RecursionLimit överskreds.

Exempel

I följande exempel visas en enkel bild av hur du serialiserar och deserialiserar dataobjekt.

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

Det kräver en klass med namnet Person, som visas i följande exempel.

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

Kommentarer

När instansen JavaScriptSerializer serialiserar en typ som en anpassad konverterare är registrerad för anropar serialiseraren Serialize metoden för att hämta ordlistan med namn/värde-par som ska konverteras till en JSON-sträng.

Metoden Serialize kan också utlösa undantag om objektdiagrammet är för komplext eller om registrerade instanser av JavaScriptConverter har orsakat konverterarens rekursion.

Gäller för

Serialize(Object, StringBuilder)

Serialiserar ett objekt och skriver den resulterande JSON-strängen till det angivna StringBuilder objektet.

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)

Parametrar

obj
Object

Objektet som ska serialiseras.

output
StringBuilder

Objektet StringBuilder som används för att skriva JSON-strängen.

Undantag

InvalidOperationException

Den resulterande JSON-strängen överskrider värdet MaxJsonLengthför .

-eller-

obj innehåller en cirkelreferens. En cirkelreferens inträffar när ett underordnat objekt har en referens till ett överordnat objekt och det överordnade objektet har en referens till det underordnade objektet.

ArgumentException

Rekursionsgränsen som definierades av RecursionLimit överskreds.

ArgumentNullException

output är null.

Kommentarer

När instansen JavaScriptSerializer serialiserar en typ som en anpassad konverterare är registrerad för anropar serialiseraren Serialize metoden för att hämta ordlistan med namn/värde-par som ska konverteras till en JSON-sträng.

Metoden Serialize kan också utlösa undantag om objektdiagrammet är för komplext eller om registrerade instanser av JavaScriptConverter har orsakat konverterarens rekursion.

Gäller för