SurrogateSelector クラスとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

SurrogateSelector クラス

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As SurrogateSelector

[ComVisibleAttribute(true)] 
public class SurrogateSelector : ISurrogateSelector

C++

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

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

JScript

ComVisibleAttribute(true) 
public class SurrogateSelector implements ISurrogateSelector

解説

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

使用例

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

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