SurrogateSelector

.NET Framework クラス ライブラリ リファレンス

SurrogateSelector クラス

シリアル化処理または逆シリアル化処理にデリゲートするシリアル化サロゲートの選択のために、フォーマッタを支援します。

名前空間: System.Runtime.Serialization
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public Class SurrogateSelector
    Implements ISurrogateSelector

Visual Basic (使用法)

Dim instance As SurrogateSelector

C#

[ComVisibleAttribute(true)] 
public class SurrogateSelector : ISurrogateSelector

C++

[ComVisibleAttribute(true)] 
public ref class SurrogateSelector : ISurrogateSelector

J#

/** @attribute ComVisibleAttribute(true) */ 
public class SurrogateSelector implements ISurrogateSelector

JScript

ComVisibleAttribute(true) 
public class SurrogateSelector implements ISurrogateSelector

解説

シリアル化サロゲートは、異なるオブジェクトのシリアル化要件を処理し、必要に応じてシリアル化データを変換できるオブジェクトをユーザーに提供します。

使用例

それ自体はシリアル化できないクラスを正しくシリアル化または逆シリアル化する方法を知っている、シリアル化サロゲート クラスを作成する方法を次のコード例に示します。さらにこの例では、SerializationException から回復する方法も示します。

C#

using System;
using System.IO;
using System.Runtime.Serialization;
using System.Runtime.Serialization.Formatters;
using System.Runtime.Serialization.Formatters.Binary;


// This class is not serializable.
class Employee 
    {
    public String name, address;

    public Employee(String name, String address) 
    {
        this.name = name;
        this.address = address;
    }
}

// This class can manually serialize an Employee object.
sealed class EmployeeSerializationSurrogate : ISerializationSurrogate
 
{

    // Serialize the Employee object to save the objects name and address
 fields.
    public void GetObjectData(Object obj, 
        SerializationInfo info, StreamingContext context) 
    {

        Employee emp = (Employee) obj;
        info.AddValue("name", emp.name);
        info.AddValue("address", emp.address);
    }

    // Deserialize the Employee object to set the objects name and address
 fields.
    public Object SetObjectData(Object obj,
        SerializationInfo info, StreamingContext context,
        ISurrogateSelector selector) 
    {

        Employee emp = (Employee) obj;
        emp.name = info.GetString("name");
        emp.address = info.GetString("address");
        return null;
    }
}

public sealed class App 
{
    static void Main() 
    {
        // This sample uses the BinaryFormatter.
        IFormatter formatter = new BinaryFormatter();

        // Create a MemoryStream that the object will be serialized
 into and deserialized from.
        using (Stream stream = new MemoryStream())
 
        {
            // Create a SurrogateSelector.
            SurrogateSelector ss = new SurrogateSelector();

            // Tell the SurrogateSelector that Employee objects are
 serialized and deserialized 
            // using the EmployeeSerializationSurrogate object.
            ss.AddSurrogate(typeof(Employee),
            new StreamingContext(StreamingContextStates.All),
            new EmployeeSerializationSurrogate());

            // Associate the SurrogateSelector with the BinaryFormatter.
            formatter.SurrogateSelector = ss;

            try 
            {
                // Serialize an Employee object into the memory stream.
                formatter.Serialize(stream, new Employee("Jeff",
 "1 Microsoft Way"));
            }
            catch (SerializationException e) 
            {
                Console.WriteLine("Serialization failed: {0}", e.Message);
                throw;
            }

            // Rewind the MemoryStream.
            stream.Position = 0;

            try 
            {
                // Deserialize the Employee object from the memory stream.
                Employee emp = (Employee) formatter.Deserialize(stream);

                // Verify that it all worked.
                Console.WriteLine("Name = {0}, Address = {1}", emp.name,
 emp.address);
            }
            catch (SerializationException e) 
            {
                Console.WriteLine("Deserialization failed: {0}", e.Message);
                throw;
            }
        }
    }
}

// This code produces the following output.
//
// Name = Jeff, Address = 1 Microsoft Way

継承階層

System.Object
  System.Runtime.Serialization.SurrogateSelector

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
SurrogateSelector メンバ
System.Runtime.Serialization 名前空間

SurrogateSelector コンストラクタ

SurrogateSelector クラスの新しいインスタンスを初期化します。

名前空間: System.Runtime.Serialization
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New SurrogateSelector

C#

public SurrogateSelector ()

C++

public:
SurrogateSelector ()

J#

public SurrogateSelector ()

JScript

public function SurrogateSelector ()

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
SurrogateSelector クラス
SurrogateSelector メンバ
System.Runtime.Serialization 名前空間

SurrogateSelector メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	AddSurrogate	確認済みのサロゲートのリストにサロゲートを追加します。
	ChainSelector	特定のオブジェクト型を処理できる、指定した ISurrogateSelector をサロゲートのリストに追加します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetNextSelector	セレクタのチェインの、次のセレクタを返します。
	GetSurrogate	特定の型のサロゲートを返します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	RemoveSurrogate	指定した型に関連付けられているサロゲートを削除します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

SurrogateSelector クラス
System.Runtime.Serialization 名前空間

SurrogateSelector メンバ

シリアル化処理または逆シリアル化処理にデリゲートするシリアル化サロゲートの選択のために、フォーマッタを支援します。

SurrogateSelector データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	SurrogateSelector	SurrogateSelector クラスの新しいインスタンスを初期化します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	AddSurrogate	確認済みのサロゲートのリストにサロゲートを追加します。
	ChainSelector	特定のオブジェクト型を処理できる、指定した ISurrogateSelector をサロゲートのリストに追加します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetNextSelector	セレクタのチェインの、次のセレクタを返します。
	GetSurrogate	特定の型のサロゲートを返します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	RemoveSurrogate	指定した型に関連付けられているサロゲートを削除します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

SurrogateSelector クラス
System.Runtime.Serialization 名前空間