FormatterServices.GetObjectData メソッド

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

FormatterServices.GetObjectData メソッド

指定したオブジェクトからデータを抽出し、オブジェクトの配列として返します。

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

Visual Basic (宣言)

Public Shared Function GetObjectData
 ( _
    obj As Object, _
    members As MemberInfo() _
) As Object()

Visual Basic (使用法)

Dim obj As Object
Dim members As MemberInfo()
Dim returnValue As Object()

returnValue = FormatterServices.GetObjectData(obj, members)

C#

public static Object[] GetObjectData (
    Object obj,
    MemberInfo[] members
)

C++

public:
static array<Object^>^ GetObjectData (
    Object^ obj, 
    array<MemberInfo^>^ members
)

J#

public static Object[] GetObjectData (
    Object obj, 
    MemberInfo[] members
)

JScript

public static function GetObjectData
 (
    obj : Object, 
    members : MemberInfo[]
) : Object[]

パラメータ

obj

フォーマッタに書き込むオブジェクト。

members

オブジェクトから抽出するメンバ。

戻り値
obj に関連付けられて members に格納されたデータを含む Object の配列。

例外

例外の種類	条件
ArgumentNullException	obj パラメータまたは members パラメータが null 参照 (Visual Basic では Nothing) です。 members の要素が null 参照 (Visual Basic では Nothing) です。
SerializationException	members の要素がフィールドを表していません。

解説

members 配列の提供された各メンバに対して、GetObjectData メソッドが obj オブジェクトに関連付けられている値を抽出し、返します。返された配列の長さは、members 配列の長さと同じです。

使用例

Book クラスのインスタンスを作成し、そのインスタンスのフィールド値を設定する例を次に示します。このコードでは、次に GetSerializableMembers メソッドを使用して型情報を取得します。また、GetObjectData メソッドを使用して、インスタンスのデータをオブジェクトの配列にコピーします。さらに、GetSafeUninitializedObject メソッドを使用して、初期化前の状態に戻したクラスの新しいインスタンスを作成します。最後に、PopulateObjectMembers メソッドを使用して、1 つ目のインスタンスのデータを 2 つ目のインスタンスにコピーします。

Visual Basic

Imports System
Imports System.Collections
Imports System.Runtime.Serialization
Imports System.IO
Imports System.Reflection
Imports System.Security.Permissions

<Assembly: SecurityPermission(SecurityAction.RequestMinimum)> 

' The SerializableAttribute specifies that instances of the class 
' can be serialized by the BinaryFormatter or SoapFormatter.
<Serializable()> _
Class Book
    Public Title As String
    Public Author As String

    ' Constructor for setting new values.
    Public Sub New(ByVal
 newTitle As String, _
    ByVal newAuthor As String)
        Title = newTitle
        Author = newAuthor

    End Sub
End Class

<SecurityPermission(SecurityAction.Demand)> _
               Public NotInheritable Class
 Test

    Public Shared Sub Main()
        Try
            Run()
        Catch exc As System.Exception
            Console.WriteLine("{0}: {1}", _
            exc.Message, exc.StackTrace)
        Finally
            Console.WriteLine("Press <Enter> to exit....")
            Console.ReadLine()
        End Try

    End Sub


    Shared Sub Run()
        ' Create an instance of a Book class 
        ' with a title and author.
        Dim Book1 As New
 Book("Book Title 1", "Masato
 Kawai")

        ' Store data about the serializable members in a 
        ' MemberInfo array. The MemberInfo type holds 
        ' only type data, not instance data.
        Dim members As MemberInfo() = _
           FormatterServices.GetSerializableMembers(GetType(Book))

        ' Copy the data from the first book into an 
        ' array of objects.
        Dim data As Object()
 = _
            FormatterServices.GetObjectData(Book1, members)

        ' Create an uninitialized instance of the Book class.
        Dim Book1Copy As Book = _
        CType(FormatterServices.GetSafeUninitializedObject _
           (GetType(Book)), Book)

        ' Call the PopuluateObjectMembers to copy the
        ' data into the new Book instance.
        FormatterServices.PopulateObjectMembers _
        (Book1Copy, members, data)

        ' Print the data from the copy.
        Console.WriteLine("Title: {0}", Book1Copy.Title)
        Console.WriteLine("Author: {0}", Book1Copy.Author)

    End Sub

    ' A private constructor is good practice on
    ' a class containing only static methods.
    Private Sub New()

    End Sub
End Class

C#

using System;
using System.Collections;
using System.Runtime.Serialization;
using System.IO;
using System.Reflection;
using System.Security.Permissions;

[assembly: SecurityPermission(SecurityAction.RequestMinimum)]
namespace Examples
{
    // The SerializableAttribute specifies that instances of the class
 
    // can be serialized by the BinaryFormatter or SoapFormatter.
    [Serializable]
    class Book
    {
        public string Title;
        public string Author;

        // Constructor for setting new values.
        public Book(string newTitle, string
 newAuthor)
        {
            Title = newTitle;
            Author = newAuthor;
        }
    }

    [SecurityPermission(SecurityAction.Demand)]
    public sealed class Test
    {
        public static void
 Main()
        {
            try
            {
                Run();
            }
            catch (System.Exception exc)
            {
                Console.WriteLine("{0}: {1}", exc.Message, exc.StackTrace);
            }
            finally
            {
                Console.WriteLine("Press <Enter> to exit....");
                Console.ReadLine();
            }
        }

        
        static void Run()
        {
            // Create an instance of a Book class 
            // with a title and author.
            Book Book1 = new Book("Book Title 1",
                "Masato Kawai");

            // Store data about the serializable members in a 
            // MemberInfo array. The MemberInfo type holds 
            // only type data, not instance data.
            MemberInfo[] members =
               FormatterServices.GetSerializableMembers
               (typeof(Book));

            // Copy the data from the first book into an 
            // array of objects.
            object[] data =
                FormatterServices.GetObjectData(Book1, members);

            // Create an uninitialized instance of the Book class.
            Book Book1Copy =
                (Book)FormatterServices.GetSafeUninitializedObject
                (typeof(Book));

            // Call the PopuluateObjectMembers to copy the
            // data into the new Book instance.
            FormatterServices.PopulateObjectMembers
                (Book1Copy, members, data);

            // Print the data from the copy.
            Console.WriteLine("Title: {0}", Book1Copy.Title);
            Console.WriteLine("Author: {0}", Book1Copy.Author);
        }
        // A private constructor is good practice on
        // a class containing only static methods.
        private Test() { }
    }
}

.NET Framework のセキュリティ

• SecurityPermission  シリアル化サービスを提供するために必要なアクセス許可。SecurityPermissionFlag.SerializationFormatter、SecurityAction.LinkDemand (関連する列挙体)

プラットフォーム

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

参照

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