JavaScriptSerializer.Serialize Method (Object)

 

Converts an object to a JSON string.

Namespace:   System.Web.Script.Serialization
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)

public string Serialize(
	object obj
)

Parameters

obj
Type: System.Object

The object to serialize.

Return Value

Type: System.String

The serialized JSON string.

Exception Condition
InvalidOperationException

The resulting JSON string exceeds the value of MaxJsonLength.

-or-

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.

ArgumentException

The recursion limit defined by RecursionLimit was exceeded.

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.

The Serialize method can also throw exceptions if the object graph is too complex, or if registered instances of JavaScriptConverter have caused converter recursion.

The following example provides a simple illustration of how to serialize and deserialize data objects. It requires a class names Person which is shown below.

.NET Framework
Available since 3.5
Return to top
Show: