JavaScriptSerializer.RegisterConverters メソッド

定義

名前空間:
System.Web.Script.Serialization
アセンブリ:
System.Web.Extensions.dll

カスタム コンバーターを JavaScriptSerializer インスタンスに登録します。

public:
 void RegisterConverters(System::Collections::Generic::IEnumerable<System::Web::Script::Serialization::JavaScriptConverter ^> ^ converters);
public void RegisterConverters(System.Collections.Generic.IEnumerable<System.Web.Script.Serialization.JavaScriptConverter> converters);
member this.RegisterConverters : seq<System.Web.Script.Serialization.JavaScriptConverter> -> unit
Public Sub RegisterConverters (converters As IEnumerable(Of JavaScriptConverter))

パラメーター

converters
IEnumerable<JavaScriptConverter>

登録するカスタム コンバーターを含む配列。

例外

ArgumentNullException

converters は nullです。

例

次の例は、カスタム コンバーターを JavaScriptSerializer インスタンスに登録する方法を示しています。 このコード例は、 JavaScriptSerializer クラスに提供されるより大きな例の一部です。

serializer = new JavaScriptSerializer();

// Register the custom converter.
serializer.RegisterConverters(new JavaScriptConverter[] { 
    new System.Web.Script.Serialization.CS.ListItemCollectionConverter() });

    serializer = New JavaScriptSerializer()

    ' Register the custom converter.
    serializer.RegisterConverters(New JavaScriptConverter() _
        {New System.Web.Script.Serialization.VB.ListItemCollectionConverter()})

注釈

RegisterConverters メソッドを使用して、JavaScriptSerializer インスタンスに 1 つ以上のカスタム コンバーターを登録できます。 カスタム コンバーターが登録されると、 JavaScriptSerializer は、マネージド型のシリアル化と JSON 文字列のマネージド型への逆シリアル化の両方にコンバーターを使用します。

複数のコンバーターを同じ JavaScriptSerializer インスタンスに登録でき、これらのコンバーターは同じ型のサポートを示すことができます。 その結果、特定の型に登録されている最後のコンバーターは、型をシリアル化するために JavaScriptSerializer によって使用されます。

カスタム コンバーターの詳細については、 JavaScriptConverter クラスを参照してください。

適用対象