IDeserializationCallback インターフェイス

[アーティクル]
03/28/2008

オブジェクトグラフ全体の逆シリアル化が完了した時点でクラスに通知することを示します。

この型のすべてのメンバの一覧については、IDeserializationCallback メンバを参照してください。

Public Interface IDeserializationCallback
[C#]
public interface IDeserializationCallback
[C++]
public __gc __interface IDeserializationCallback
[JScript]
public interface IDeserializationCallback

IDeserializationCallback を実装するクラス

クラス	説明
AssemblyName	アセンブリの一意の ID を完全に記述します。
CompareInfo	カルチャごとに異なる文字列比較行うための一連のメソッドを実装します。
Hashtable	キーのハッシュコードに基づいて編成された、キーと値の組み合わせのコレクションを表します。
NameObjectCollectionBase	関連付けられた String キーおよび Object 値のコレクションの抽象 (Visual Basic では MustInherit) 基本クラスを提供します。これらのキーおよび値には、キーまたはインデックスのいずれかを使用してアクセスできます。
PermissionSet	複数の異なる種類のアクセス許可を格納できるコレクションを表します。
TextInfo	大文字と小文字を区別するかどうかなど、書記体系に固有なプロパティと動作を定義します。
WindowsIdentity	Windows ユーザーを表します。

解説

実装時の注意: オブジェクトグラフの逆シリアル化が完了すると呼び出されるメソッドに対するサポートの一部として、現在のインターフェイスを実装します。

オブジェクトがその子オブジェクトでコードを実行する必要がある場合は、このアクションを延期し、 IDeserializationCallback を実装して、このインターフェイスでコールバックされたときにだけコードを実行できます。

使用例

 
Imports System
Imports System.IO
Imports System.Collections
Imports System.Runtime.Serialization.Formatters.Binary
Imports System.Runtime.Serialization

' This class is serializable and will have its OnDeserialization method
' called after each instance of this class is deserialized.
<Serializable()> Class Circle
   Implements IDeserializationCallback
   Private m_radius As Double

   ' To reduce the size of the serialization stream, the field below is 
   ' not serialized. This field is calculated when an object is constructed
   ' or after an instance of this class is deserialized.
   <NonSerialized()> Public m_area As Double

   Public Sub New(ByVal radius As Double)
      m_radius = radius
      m_area = Math.PI * radius * radius
   End Sub

   Private Sub OnDeserialization(ByVal sender As Object) _
      Implements IDeserializationCallback.OnDeserialization
      ' After being deserialized, initialize the m_area field 
      ' using the deserialized m_radius value.
      m_area = Math.PI * m_radius * m_radius
   End Sub

   Public Overrides Function ToString() As String
      Return String.Format("radius={0}, area={1}", m_radius, m_area)
   End Function
End Class


Class Class1
   <STAThread()> Shared Sub Main()
      Serialize()
      Deserialize()
   End Sub

   Shared Sub Serialize()
      Dim c As New Circle(10)
      Console.WriteLine("Object being serialized: " + c.ToString())

      ' To serialize the Circle, you must first open a stream for 
      ' writing. Use a file stream here.
      Dim fs As New FileStream("DataFile.dat", FileMode.Create)

      ' Construct a BinaryFormatter and use it 
      ' to serialize the data to the stream.
      Dim formatter As New BinaryFormatter
      Try
         formatter.Serialize(fs, c)
      Catch e As SerializationException
         Console.WriteLine("Failed to serialize. Reason: " + e.Message)
         Throw
      Finally
         fs.Close()
      End Try
   End Sub


   Shared Sub Deserialize()
      ' Declare the Circle reference
      Dim c As Circle = Nothing

      ' Open the file containing the data that you want to deserialize.
      Dim fs As New FileStream("DataFile.dat", FileMode.Open)
      Try
         Dim formatter As New BinaryFormatter

         ' Deserialize the Circle from the file and 
         ' assign the reference to the local variable.
         c = CType(formatter.Deserialize(fs), Circle)
      Catch e As SerializationException
         Console.WriteLine("Failed to deserialize. Reason: " + e.Message)
         Throw
      Finally
         fs.Close()
      End Try

      ' To prove that the Circle deserialized correctly, display its area.
      Console.WriteLine("Object being deserialized: " + c.ToString())
   End Sub
End Class

[C#] 
using System;
using System.IO;
using System.Collections;
using System.Runtime.Serialization.Formatters.Binary;
using System.Runtime.Serialization;

// This class is serializable and will have its OnDeserialization method
// called after each instance of this class is deserialized.
[Serializable]
class Circle : IDeserializationCallback 
{
    Double m_radius;

    // To reduce the size of the serialization stream, the field below is 
    // not serialized. This field is calculated when an object is constructed
    // or after an instance of this class is deserialized.
    [NonSerialized] public Double m_area;

    public Circle(Double radius) 
    {
        m_radius = radius;
        m_area = Math.PI * radius * radius;
    }

    void IDeserializationCallback.OnDeserialization(Object sender) 
    {
        // After being deserialized, initialize the m_area field 
        // using the deserialized m_radius value.
        m_area = Math.PI * m_radius * m_radius;
    }

    public override String ToString() 
    {
        return String.Format("radius={0}, area={1}", m_radius, m_area);
    }
}


class Class1 
{
    [STAThread]
    static void Main(string[] args) 
    {
        Serialize();
        Deserialize();
    }

    static void Serialize() 
    {
        Circle c = new Circle(10);
        Console.WriteLine("Object being serialized: " + c.ToString());

        // To serialize the Circle, you must first open a stream for 
        // writing. Use a file stream here.
        FileStream fs = new FileStream("DataFile.dat", FileMode.Create);

        // Construct a BinaryFormatter and use it 
        // to serialize the data to the stream.
        BinaryFormatter formatter = new BinaryFormatter();
        try 
        {
            formatter.Serialize(fs, c);
        }
        catch (SerializationException e) 
        {
            Console.WriteLine("Failed to serialize. Reason: " + e.Message);
            throw;
        }
        finally 
        {
            fs.Close();
        }
    }

   
    static void Deserialize() 
    {
        // Declare the Circle reference.
        Circle c = null;

        // Open the file containing the data that you want to deserialize.
        FileStream fs = new FileStream("DataFile.dat", FileMode.Open);
        try 
        {
            BinaryFormatter formatter = new BinaryFormatter();

            // Deserialize the Circle from the file and 
            // assign the reference to the local variable.
            c = (Circle) formatter.Deserialize(fs);
        }
        catch (SerializationException e) 
        {
            Console.WriteLine("Failed to deserialize. Reason: " + e.Message);
            throw;
        }
        finally 
        {
            fs.Close();
        }

        // To prove that the Circle deserialized correctly, display its area.
        Console.WriteLine("Object being deserialized: " + c.ToString());
    }
}

[C++] 
#using <mscorlib.dll>

using namespace System;
using namespace System::IO;
using namespace System::Collections;
using namespace System::Runtime::Serialization::Formatters::Binary;
using namespace System::Runtime::Serialization;

// This class is serializable and will have its OnDeserialization method
// called after each instance of this class is deserialized.
[Serializable]
__gc class Circle : public IDeserializationCallback
{
   Double m_radius;

   // To reduce the size of the serialization stream, the field below is 
   // not serialized. This field is calculated when an object is constructed
   // or after an instance of this class is deserialized.
public:
   [NonSerialized]
   Double m_area;

public:
   Circle(Double radius) 
   {
      m_radius = radius;
      m_area = Math::PI * radius * radius;
   }

   void OnDeserialization(Object* /*sender*/) 
   {
      // After being deserialized, initialize the m_area field 
      // using the deserialized m_radius value.
      m_area = Math::PI * m_radius * m_radius;
   }

public:
   String* ToString() 
   {
      return String::Format(S"radius= {0}, area= {1}", __box(m_radius), __box(m_area));
   }
};


void Serialize() 
{
   Circle* c = new Circle(10);
   Console::WriteLine(S"Object being serialized: {0}", c);

   // To serialize the Circle, you must first open a stream for 
   // writing. We will use a file stream here.
   FileStream* fs = new FileStream(S"DataFile.dat", FileMode::Create);

   // Construct a BinaryFormatter and use it to serialize the data to the stream.
   BinaryFormatter* formatter = new BinaryFormatter();
   try 
   {
      formatter->Serialize(fs, c);
   }
   catch (SerializationException* e) 
   {
      Console::WriteLine(S"Failed to serialize. Reason: {0}", e->Message);
      throw;
   }
   __finally 
   {
      fs->Close();
   }
}

void Deserialize() 
{
   // Declare the Circle reference.
   Circle* c = 0;

   // Open the file containing the data that we want to deserialize.
   FileStream* fs = new FileStream(S"DataFile.dat", FileMode::Open);
   try 
   {
      BinaryFormatter* formatter = new BinaryFormatter();

      // Deserialize the Circle from the file and 
      // assign the reference to our local variable.
      c = dynamic_cast<Circle*>(formatter->Deserialize(fs));
   } 
   catch (SerializationException* e) 
   {
      Console::WriteLine(S"Failed to deserialize. Reason: {0}", e->Message);
      throw;
   }
   __finally 
   {
      fs->Close();
   }

   // To prove that the Circle deserialized correctly, display its area.
   Console::WriteLine(S"Object being deserialized: {0}", c);
}

[STAThread]
int main() 
{
   Serialize();
   Deserialize();
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

名前空間: System.Runtime.Serialization

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

アセンブリ: Mscorlib (Mscorlib.dll 内)

参照

IDeserializationCallback メンバ | System.Runtime.Serialization 名前空間 | イベントとデリゲート | XML シリアル化および SOAP シリアル化

次の方法で共有

IDeserializationCallback インターフェイス

IDeserializationCallback を実装するクラス

解説

使用例

必要条件

参照

その他のリソース