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

すべての辞書から再検索する

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

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

OnSerializedAttribute クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

メソッドに適用すると、そのメソッドがオブジェクトグラフのシリアル化後に呼び出されるよう指定します。

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

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
<AttributeUsageAttribute(AttributeTargets.Method, Inherited:=False)> _
Public NotInheritable Class
 OnSerializedAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As OnSerializedAttribute

[ComVisibleAttribute(true)] 
[AttributeUsageAttribute(AttributeTargets.Method, Inherited=false)]
 
public sealed class OnSerializedAttribute :
 Attribute

C++

[ComVisibleAttribute(true)] 
[AttributeUsageAttribute(AttributeTargets::Method, Inherited=false)]
 
public ref class OnSerializedAttribute sealed
 : public Attribute

/** @attribute ComVisibleAttribute(true) */ 
/** @attribute AttributeUsageAttribute(AttributeTargets.Method, Inherited=false)
 */ 
public final class OnSerializedAttribute extends
 Attribute

JScript

ComVisibleAttribute(true) 
AttributeUsageAttribute(AttributeTargets.Method, Inherited=false)
 
public final class OnSerializedAttribute extends
 Attribute

解説

OnSerializedAttribute を使用すると、シリアル化の実行後にオブジェクトを操作できます。

OnSerializedAttribute を使用するには、メソッドに StreamingContext パラメータが含まれている必要があります。この属性により、メソッドがシリアル化インフラストラクチャによって呼び出されるようマークされます。また StreamingContext には、実行されるシリアル化のタイプに関する追加のデータが含まれています。次のコードは、その使用法を示しています。

\\ C#
[OnSerializedAttribute()]
internal void RunThisMethod(StreamingContext context)
{ 
    // Code not shown.
}
' Visual Basic
<OnSerializedAttribute()> _
Private Sub RunThisMethod(context As StreamingContext)
    ' Code not shown.
End Sub

メモ
コードでは、OnSerializedAttribute の代わりに OnSerialized という短い語を使用できます。

使用例

次の例では、OnDeserializedAttribute、OnSerializingAttribute、OnSerializedAttribute、および OnDeserializingAttribute の各属性を、クラス内のメソッドに適用しています。

Visual Basic

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

Public Class Test
    Public Shared Sub Main()
 
        ' Create a new TestSimpleObject object.
        Dim obj As New TestSimpleObject()
        
        Console.WriteLine(vbLf + " Before serialization the object
 contains: ")
        obj.Print()
        
        ' Open a file and serialize the object into binary format.
        Dim stream As Stream = File.Open("DataFile.dat",
 FileMode.Create)
        Dim formatter As New
 BinaryFormatter()
        
        Try
            formatter.Serialize(stream, obj)
            
            ' Print the object again to see the effect of the 
            'OnSerializedAttribute.
            Console.WriteLine(vbLf + " After serialization the
 object contains: ")
            obj.Print()
            
            ' Set the original variable to null.
            obj = Nothing
            stream.Close()
            
            ' Open the file "data.xml" and deserialize the
 object from it.
            stream = File.Open("DataFile.dat", FileMode.Open)
            
            ' Deserialize the object from the data file.
            obj = CType(formatter.Deserialize(stream), TestSimpleObject)
            
            Console.WriteLine(vbLf + " After deserialization the
 object contains: ")
            obj.Print()
        Catch se As SerializationException
            Console.WriteLine("Failed to serialize. Reason: "
 + se.Message)
            Throw
        Catch exc As Exception
            Console.WriteLine("An exception occurred. Reason:
 " + exc.Message)
            Throw
        Finally
            stream.Close()
            obj = Nothing
            formatter = Nothing
        End Try
    End Sub 
End Class 


' This is the object that will be serialized and deserialized.
<Serializable()>  _
Public Class TestSimpleObject
    ' This member is serialized and deserialized with no change.
    Public member1 As Integer
    
    ' The value of this field is set and reset during and 
    ' after serialization.
    Private member2 As String
    
    ' This field is not serialized. The OnDeserializedAttribute 
    ' is used to set the member value after serialization.
    <NonSerialized()>  _
    Public member3 As String
    
    ' This field is set to null, but populated after deserialization.
    Private member4 As String
    
    ' Constructor for the class.
    Public Sub New() 
        member1 = 11
        member2 = "Hello World!"
        member3 = "This is a nonserialized value"
        member4 = Nothing
    End Sub
    
    Public Sub Print() 
        Console.WriteLine("member1 = '{0}'", member1)
        Console.WriteLine("member2 = '{0}'", member2)
        Console.WriteLine("member3 = '{0}'", member3)
        Console.WriteLine("member4 = '{0}'", member4)
    End Sub
    
    <OnSerializing()>  _
    Friend Sub OnSerializingMethod(ByVal
 context As StreamingContext) 
        member2 = "This value went into the data file during serialization."
    End Sub
    
    <OnSerialized()>  _
    Friend Sub OnSerializedMethod(ByVal
 context As StreamingContext) 
        member2 = "This value was reset after serialization."
    End Sub
    
    <OnDeserializing()>  _
    Friend Sub OnDeserializingMethod(ByVal
 context As StreamingContext) 
        member3 = "This value was set during deserialization"
    End Sub
    
    <OnDeserialized()>  _
    Friend Sub OnDeserializedMethod(ByVal
 context As StreamingContext) 
        member4 = "This value was set after deserialization."
    End Sub 
End Class 

' Output:
'  Before serialization the object contains: 
' member1 = '11'
' member2 = 'Hello World!'
' member3 = 'This is a nonserialized value'
' member4 = ''
'
'  After serialization the object contains: 
' member1 = '11'
' member2 = 'This value was reset after serialization.'
' member3 = 'This is a nonserialized value'
' member4 = ''
'
'  After deserialization the object contains: 
' member1 = '11'
' member2 = 'This value went into the data file during serialization.'
' member3 = 'This value was set during deserialization'
' member4 = 'This value was set after deserialization.'

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

public class Test 
{
    public static void Main()
  
    {
        // Create a new TestSimpleObject object.
        TestSimpleObject obj = new TestSimpleObject();

        Console.WriteLine("\n Before serialization the object contains: ");
        obj.Print();

        // Open a file and serialize the object into binary format.
        Stream stream = File.Open("DataFile.dat", FileMode.Create);
        BinaryFormatter formatter = new BinaryFormatter();

        try
        {
            formatter.Serialize(stream, obj);
            
            // Print the object again to see the effect of the 
            //OnSerializedAttribute.
            Console.WriteLine("\n After serialization the object contains: ");
            obj.Print();

            // Set the original variable to null.
            obj = null;
            stream.Close();  

            // Open the file "data.xml" and deserialize the
 object from it.
            stream = File.Open("DataFile.dat", FileMode.Open);

            // Deserialize the object from the data file.
            obj = (TestSimpleObject)formatter.Deserialize(stream);

            Console.WriteLine("\n After deserialization the object contains:
 ");
            obj.Print();
        }
        catch (SerializationException se)
        {
            Console.WriteLine("Failed to serialize. Reason: " + se.Message);
            throw;
        }
        catch (Exception exc)
        {
            Console.WriteLine("An exception occurred. Reason: " + exc.Message);
            throw;
        }
        finally
        {
            stream.Close();
            obj = null;
            formatter = null;
        }

    }
}


// This is the object that will be serialized and deserialized.
[Serializable()]        
public class TestSimpleObject  
{
    // This member is serialized and deserialized with no change.
    public int member1;

    // The value of this field is set and reset during and 
    // after serialization.
    private string member2;

    // This field is not serialized. The OnDeserializedAttribute 
    // is used to set the member value after serialization.
    [NonSerialized()] 
    public string member3; 

    // This field is set to null, but populated after deserialization.
    private string member4;

    // Constructor for the class.
    public TestSimpleObject() 
    {
        member1 = 11;
        member2 = "Hello World!";
        member3 = "This is a nonserialized value";
        member4 = null;
    }

    public void Print() 
    {
        Console.WriteLine("member1 = '{0}'", member1);
        Console.WriteLine("member2 = '{0}'", member2);
        Console.WriteLine("member3 = '{0}'", member3);
        Console.WriteLine("member4 = '{0}'", member4);
    }

    [OnSerializing()]
    internal void OnSerializingMethod(StreamingContext context)
    {
        member2 = "This value went into the data file during serialization.";
    }

    [OnSerialized()]
    internal void OnSerializedMethod(StreamingContext context)
    {
        member2 = "This value was reset after serialization.";
    }

    [OnDeserializing()]
    internal void OnDeserializingMethod(StreamingContext context)
    {
        member3 = "This value was set during deserialization";
    }

    [OnDeserialized()]
    internal void OnDeserializedMethod(StreamingContext context)
    {
        member4 = "This value was set after deserialization.";
    }    
}

// Output:
//  Before serialization the object contains: 
// member1 = '11'
// member2 = 'Hello World!'
// member3 = 'This is a nonserialized value'
// member4 = ''
//
//  After serialization the object contains: 
// member1 = '11'
// member2 = 'This value was reset after serialization.'
// member3 = 'This is a nonserialized value'
// member4 = ''
//
//  After deserialization the object contains: 
// member1 = '11'
// member2 = 'This value went into the data file during serialization.'
// member3 = 'This value was set during deserialization'
// member4 = 'This value was set after deserialization.'

継承階層

System.Object
System.Attribute
System.Runtime.Serialization.OnSerializedAttribute

スレッドセーフ

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

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
OnSerializedAttribute メンバ
System.Runtime.Serialization 名前空間
BinaryFormatter
OnDeserializedAttribute クラス
OnDeserializingAttribute クラス
OnSerializingAttribute
SoapFormatter

このページでは「.NET Framework クラスライブラリリファレンス」からOnSerializedAttribute クラスを検索した結果を表示しています。
Weblioに収録されているすべての辞書からOnSerializedAttribute クラスを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からOnSerializedAttribute クラスを検索

>> 「OnSerializedAttribute クラス」を含む用語の索引
OnSerializedAttribute クラスのページへのリンク

OnSerializedAttribute クラスとは？わかりやすく解説

OnSerializedAttribute クラス

「OnSerializedAttribute クラス」の関連用語


	© 2025 Microsoft.All rights reserved.

OnSerializedAttribute クラスとは？ わかりやすく解説

OnSerializedAttribute クラス

急上昇のことば

「OnSerializedAttribute クラス」の関連用語

OnSerializedAttribute クラスとは？わかりやすく解説