JavaScriptSerializer.Serialize Methode

Definition

Namespace:
System.Web.Script.Serialization
Assembly:
System.Web.Extensions.dll

Konvertiert ein Objekt in eine JSON-Zeichenfolge.

Überlädt

Name Beschreibung
Serialize(Object)

Konvertiert ein Objekt in eine JSON-Zeichenfolge.
Serialize(Object, StringBuilder)

Serialisiert ein Objekt und schreibt die resultierende JSON-Zeichenfolge in das angegebene StringBuilder Objekt.

Serialize(Object)

Konvertiert ein Objekt in eine JSON-Zeichenfolge.

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

Parameter

obj
Object

Das zu serialisierende Objekt.

Gibt zurück

String

Die serialisierte JSON-Zeichenfolge.

Ausnahmen

InvalidOperationException

Die resultierende JSON-Zeichenfolge überschreitet den Wert von MaxJsonLength.

-oder-

obj enthält einen Zirkelbezug. Ein Zirkelbezug tritt auf, wenn ein untergeordnetes Objekt über einen Verweis auf ein übergeordnetes Objekt verfügt und das übergeordnete Objekt einen Verweis auf das untergeordnete Objekt aufweist.

ArgumentException

Die von ihnen definierte RecursionLimit Rekursionsgrenze wurde überschritten.

Beispiele

Das folgende Beispiel zeigt eine einfache Abbildung, wie Datenobjekte serialisiert und deserialisiert werden.

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

Sie erfordert eine Klasse mit dem Namen Person, die im folgenden Beispiel dargestellt wird.

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

Hinweise

Wenn die Instanz einen Typ serialisiert, für den ein benutzerdefinierter Konverter registriert ist, ruft der JavaScriptSerializer Serializer die Serialize Methode auf, um das Wörterbuch mit Namen-Wert-Paaren abzurufen, die in eine JSON-Zeichenfolge konvertiert werden.

Die Serialize Methode kann auch Ausnahmen auslösen, wenn das Objektdiagramm zu komplex ist oder wenn registrierte Instanzen von JavaScriptConverter Konverter rekursion verursacht haben.

Gilt für:

Serialize(Object, StringBuilder)

Serialisiert ein Objekt und schreibt die resultierende JSON-Zeichenfolge in das angegebene StringBuilder Objekt.

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)

Parameter

obj
Object

Das zu serialisierende Objekt.

output
StringBuilder

Das StringBuilder Objekt, das zum Schreiben der JSON-Zeichenfolge verwendet wird.

Ausnahmen

InvalidOperationException

Die resultierende JSON-Zeichenfolge überschreitet den Wert von MaxJsonLength.

-oder-

obj enthält einen Zirkelbezug. Ein Zirkelbezug tritt auf, wenn ein untergeordnetes Objekt über einen Verweis auf ein übergeordnetes Objekt verfügt und das übergeordnete Objekt einen Verweis auf das untergeordnete Objekt aufweist.

ArgumentException

Die von ihnen definierte RecursionLimit Rekursionsgrenze wurde überschritten.

ArgumentNullException

output ist null.

Hinweise

Wenn die Instanz einen Typ serialisiert, für den ein benutzerdefinierter Konverter registriert ist, ruft der JavaScriptSerializer Serializer die Serialize Methode auf, um das Wörterbuch mit Namen-Wert-Paaren abzurufen, die in eine JSON-Zeichenfolge konvertiert werden.

Die Serialize Methode kann auch Ausnahmen auslösen, wenn das Objektdiagramm zu komplex ist oder wenn registrierte Instanzen von JavaScriptConverter Konverter rekursion verursacht haben.

Gilt für: