JavaScriptConverter 类

定义

命名空间:: System.Web.Script.Serialization

程序集:: System.Web.Extensions.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

为自定义类型转换器提供抽象基类。

public ref class JavaScriptConverter abstract

public abstract class JavaScriptConverter

type JavaScriptConverter = class

Public MustInherit Class JavaScriptConverter

继承: Object
JavaScriptConverter

示例

以下示例演示如何为 ListItemCollection 类创建自定义转换器。

using System;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.Web.UI.WebControls;
using System.Collections;

namespace System.Web.Script.Serialization.CS
{
    public class ListItemCollectionConverter : JavaScriptConverter
    {

        public override IEnumerable<Type> SupportedTypes
        {
            //Define the ListItemCollection as a supported type.
            get { return new ReadOnlyCollection<Type>(new List<Type>(new Type[] { typeof(ListItemCollection) })); }
        }

        public override IDictionary<string, object> Serialize(object obj, JavaScriptSerializer serializer)
        {
            ListItemCollection listType = obj as ListItemCollection;

            if (listType != null)
            {
                // Create the representation.
                Dictionary<string, object> result = new Dictionary<string, object>();
                ArrayList itemsList = new ArrayList();
                foreach (ListItem item in listType)
                {
                    //Add each entry to the dictionary.
                    Dictionary<string, object> listDict = new Dictionary<string, object>();
                    listDict.Add("Value", item.Value);
                    listDict.Add("Text", item.Text);
                    itemsList.Add(listDict);
                }
                result["List"] = itemsList;

                return result;
            }
            return new Dictionary<string, object>();
        }

        public override object Deserialize(IDictionary<string, object> dictionary, Type type, JavaScriptSerializer serializer)
        {
            if (dictionary == null)
                throw new ArgumentNullException("dictionary");

            if (type == typeof(ListItemCollection))
            {
                // Create the instance to deserialize into.
                ListItemCollection list = new ListItemCollection();

                // Deserialize the ListItemCollection's items.
                ArrayList itemsList = (ArrayList)dictionary["List"];
                for (int i=0; i<itemsList.Count; i++)
                    list.Add(serializer.ConvertToType<ListItem>(itemsList[i]));

                return list;
            }
            return null;
        }
    }
}

Imports System.Collections.Generic
Imports System.Collections.ObjectModel
Imports System.Web.UI.WebControls
Imports System.Collections

Namespace System.Web.Script.Serialization.VB

    Public Class ListItemCollectionConverter
        Inherits JavaScriptConverter

        Public Overrides ReadOnly Property SupportedTypes() As _
            System.Collections.Generic.IEnumerable(Of System.Type)
            Get
                ' Define the ListItemCollection as a supported type.
                Return New ReadOnlyCollection(Of Type)(New List(Of Type) _
                (New Type() {GetType(ListItemCollection)}))
            End Get
        End Property

        Public Overrides Function Serialize(ByVal obj As Object, _
            ByVal serializer As JavaScriptSerializer) As _
            System.Collections.Generic.IDictionary(Of String, Object)

            Dim listType As ListItemCollection = CType(obj, ListItemCollection)

            If Not (listType Is Nothing) Then

                ' Create the representation.
                Dim result As New Dictionary(Of String, Object)

                Dim itemsList As New ArrayList()
                Dim item As ListItem
                For Each item In listType
                    ' Add each entry to the dictionary.
                    Dim listDict As New Dictionary(Of String, Object)
                    listDict.Add("Value", item.Value)
                    listDict.Add("Text", item.Text)
                    itemsList.Add(listDict)
                Next item
                result("List") = itemsList

                Return result
            End If
            Return New Dictionary(Of String, Object)
        End Function

        Public Overrides Function Deserialize(ByVal dictionary As _
            System.Collections.Generic.IDictionary(Of String, Object), _
            ByVal type As System.Type, ByVal serializer As JavaScriptSerializer) As Object

            If dictionary Is Nothing Then
                Throw New ArgumentNullException("dictionary")
            End If

            If type Is GetType(ListItemCollection) Then
                ' Create the instance to deserialize into.
                Dim list As New ListItemCollection()

                ' Deserialize the ListItemCollection's items.
                Dim itemsList As ArrayList = CType(dictionary("List"), ArrayList)
                Dim i As Integer
                For i = 0 To itemsList.Count - 1
                    list.Add(serializer.ConvertToType(Of ListItem)(itemsList(i)))
                Next i

                Return list
            End If

            Return Nothing

        End Function
    End Class
End Namespace

注解

通过 JavaScriptConverter 类，可为类本身不支持 JavaScriptSerializer 的托管类型实现序列化和反序列化过程。如果需要对序列化和反序列化过程进行更多控制，还可以使用 JavaScriptConverter 。

该 SupportedTypes 属性指示自定义转换器为其提供转换器服务的类型。

若要指示实例必须使用 JavaScriptSerializer 自定义转换器，必须将转换器注册到该实例。如果直接使用 JavaScriptSerializer 类，则应使用 RegisterConverters 该方法注册转换器。否则，如果要从 ECMAScript（JavaScript）调用 Web 方法，并且想要使用自定义转换器，则可以通过在配置文件中添加 converters 元素来注册它。有关详细信息，请参阅 How to： Configure ASP.NET Services in Microsoft Ajax.

JavaScriptSerializer当实例序列化为其注册了自定义转换器的类型时，序列化程序将调用该方法Serialize。同样，当实例反序列化 JavaScript 对象表示法（JSON）字符串并识别 JSON 字符串中的类型具有与之关联的自定义转换器时 JavaScriptSerializer ，序列化程序将调用 Deserialize 该方法。

实施者说明

从 JavaScriptConverter中继承时，必须重写以下成员：

Deserialize(IDictionary<String,Object>, Type, JavaScriptSerializer)
Serialize(Object, JavaScriptSerializer)
SupportedTypes JavaScriptSerializer ConvertToType<T>(Object)提供将由实现者JavaScriptConverter使用的方法。转换器代码必须能够获取序列化程序传递给它的字典中包含的值，然后将该值转换为类型的 T对象。可以调用 ConvertToType<T>(Object) 该方法，而不是重新实现自定义转换代码来实现此目的。

构造函数

名称	说明
JavaScriptConverter()	初始化 JavaScriptConverter 类的新实例。

属性

名称	说明
SupportedTypes	在派生类中重写时，获取支持的类型的集合。

方法

名称	说明
Deserialize(IDictionary<String,Object>, Type, JavaScriptSerializer)	在派生类中重写时，将提供的字典转换为指定类型的对象。
Equals(Object)	确定指定的对象是否等于当前对象。 (继承自 Object)
GetHashCode()	用作默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object的浅表副本。 (继承自 Object)
Serialize(Object, JavaScriptSerializer)	在派生类中重写时，生成名称/值对的字典。
ToString()	返回一个表示当前对象的字符串。 (继承自 Object)

适用于

另请参阅

反馈

此页面是否有帮助？