FormatterServices.GetObjectData-Methode

Extrahiert die Daten vom angegebenen Objekt und gibt sie als Array von Objekten zurück.

Namespace: System.Runtime.Serialization
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Shared Function GetObjectData ( _
    obj As Object, _
    members As MemberInfo() _
) As Object()
'Usage
Dim obj As Object
Dim members As MemberInfo()
Dim returnValue As Object()

returnValue = FormatterServices.GetObjectData(obj, members)

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

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

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

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

Parameter

• obj
  Das Objekt, das in das Formatierungsprogramm geschrieben werden soll.

• members
  Die Member, die aus dem Objekt extrahiert werden sollen.

Rückgabewert

Ein Array von Object mit Daten, die in members gespeichert und obj zugeordnet sind.

Ausnahmen

Hinweise

Für jeden angegebenen Member des members-Arrays extrahiert die GetObjectData-Methode den Wert, der dem obj-Objekt zugeordnet ist, und gibt ihn zurück. Die Länge des zurückgegebenen Arrays ist identisch mit der Länge des members-Arrays.

Beispiel

Im folgenden Beispiel wird eine Instanz der Book-Klasse erstellt, und es werden Feldwerte für die Instanz festgelegt. Anschließend werden mit der GetSerializableMembers-Methode die Typinformationen abgerufen. Die Instanzdaten werden mit der GetObjectData-Methode in ein Objektarray kopiert. Mit der GetSafeUninitializedObject-Methode wird eine neue nicht initialisierte Instanz der Klasse erstellt. Abschließend werden die Daten der ersten Instanz mit der PopulateObjectMembers-Methode in die zweite Instanz kopiert.

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

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-Sicherheit

• SecurityPermission  für die Bereitstellung von Serialisierungsdiensten. Zugeordnete Enumerationen: SecurityPermissionFlag.SerializationFormatter, SecurityAction.LinkDemand.

Plattformen

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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

FormatterServices-Klasse
FormatterServices-Member
System.Runtime.Serialization-Namespace