ObjectManager Osztály

Definíció

Névtér:
System.Runtime.Serialization
Szerelvény:
mscorlib.dll
Szerelvény:
netstandard.dll

A deszerializált objektumok nyomon követése.

public ref class ObjectManager
public class ObjectManager
[System.Runtime.InteropServices.ComVisible(true)]
public class ObjectManager
type ObjectManager = class
[<System.Runtime.InteropServices.ComVisible(true)>]
type ObjectManager = class
Public Class ObjectManager
Öröklődés
Object
ObjectManager
Attribútumok
ComVisibleAttribute

Példák

Az alábbi példakód bemutatja, hogyan használhatja az ObjectManager osztályt egy objektumdiagramon való végigjárásra, és hogyan lehet csak egyszer bejárni az egyes objektumokat.

using System;
using System.Text;
using System.Collections;
using System.Runtime.Serialization;
using System.Reflection;

// This class walks through all the objects once in an object graph.
public sealed class ObjectWalker : IEnumerable, IEnumerator {
   private Object m_current;

   // This stack contains the set of objects that will be enumerated.
   private Stack m_toWalk = new Stack();

   // The ObjectIDGenerator ensures that each object is enumerated just once.
   private ObjectIDGenerator m_idGen = new ObjectIDGenerator();

   // Construct an ObjectWalker passing the root of the object graph.
   public ObjectWalker(Object root) {
      Schedule(root);
   }

   // Return an enumerator so this class can be used with foreach.
   public IEnumerator GetEnumerator() {
      return this;
   }

   // Resetting the enumerator is not supported.
   public void Reset() {
      throw new NotSupportedException("Resetting the enumerator is not supported.");
   }

   // Return the enumeration's current object.
   public Object Current { get { return m_current; } }

   // Walk the reference of the passed-in object.
   private void Schedule(Object toSchedule) {
      if (toSchedule == null) return;

      // Ask the ObjectIDManager if this object has been examined before.
      Boolean firstOccurrence;
      m_idGen.GetId(toSchedule, out firstOccurrence);

      // If this object has been examined before, do not look at it again just return.
      if (!firstOccurrence) return;

      if (toSchedule.GetType().IsArray) {
         // The object is an array, schedule each element of the array to be looked at.
         foreach (Object item in ((Array)toSchedule)) Schedule(item);
      } else {
         // The object is not an array, schedule this object to be looked at.
         m_toWalk.Push(toSchedule);
      }
   }

   // Advance to the next item in the enumeration.
   public Boolean MoveNext() {
      // If there are no more items to enumerate, return false.
      if (m_toWalk.Count == 0) return false;

      // Check if the object is a terminal object (has no fields that refer to other objects).
      if (!IsTerminalObject(m_current = m_toWalk.Pop())) {
         // The object does have field, schedule the object's instance fields to be enumerated.
         foreach (FieldInfo fi in m_current.GetType().GetFields(BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic)) {
            Schedule(fi.GetValue(m_current));
         }
      }
      return true;
   }

   // Returns true if the object has no data fields with information of interest.
   private Boolean IsTerminalObject(Object data) {
      Type t = data.GetType();
      return t.IsPrimitive || t.IsEnum || t.IsPointer || data is String;
   }
}

public sealed class App {
   // Define some fields in the class to test the ObjectWalker.
   public String name = "Fred";
   public Int32 Age = 40;

   static void Main() {
      // Build an object graph using an array that refers to various objects.
      Object[] data = new Object[] { "Jeff", 123, 555L, (Byte) 35, new App() };

      // Construct an ObjectWalker and pass it the root of the object graph.
      ObjectWalker ow = new ObjectWalker(data);

      // Enumerate all of the objects in the graph and count the number of objects.
      Int64 num = 0;
      foreach (Object o in ow) {
         // Display each object's type and value as a string.
         Console.WriteLine("Object #{0}: Type={1}, Value's string={2}",
            num++, o.GetType(), o.ToString());
      }
   }
}

// This code produces the following output.
//
// Object #0: Type=App, Value's string=App
// Object #1: Type=System.Int32, Value's string=40
// Object #2: Type=System.String, Value's string=Fred
// Object #3: Type=System.Byte, Value's string=35
// Object #4: Type=System.Int64, Value's string=555
// Object #5: Type=System.Int32, Value's string=123
// Object #6: Type=System.String, Value's string=Jeff

Megjegyzések

A deszerializálás során a Formatter lekérdezések ObjectManager megállapítják, hogy a szerializált streamben lévő objektumra mutató hivatkozás olyan objektumra vonatkozik-e, amelyet már deszerializáltak (visszamenőleges hivatkozás), vagy egy olyan objektumra, amely még nem deszerializált (előre mutató hivatkozás). Ha a szerializált streamben lévő hivatkozás továbbítási hivatkozás, akkor a Formatter javítás regisztrálható a ObjectManager. Ha a szerializált streamben lévő hivatkozás visszafelé mutató hivatkozás, a Formatter hivatkozás azonnal befejeződik. A javítás az objektumhivatkozások véglegesítésének folyamatát jelenti, amely még nem fejeződött be az objektum deszerializálása során. A szükséges objektum deszerializálása után a ObjectManager program befejezi a referenciát.

A ObjectManager következő szabálykészlet határozza meg a javítás sorrendjét. Minden olyan objektum, amely implementál ISerializable vagy rendelkezik ilyen ISerializationSurrogate objektummal, az objektumfa deszerializálásakor várhatóan elérhető lesz az általuk továbbított SerializationInfo összes objektum. A szülőobjektumok azonban nem feltételezhetik, hogy az összes gyermekobjektum teljes mértékben befejeződik, ha teljesen deszerializálva van. Minden gyermekobjektum jelen lesz, de nem minden unoka objektum lesz szükségszerűen jelen. Ha egy objektumnak olyan műveleteket kell végrehajtania, amelyek a kód gyermekobjektumokon való végrehajtásától függenek, késleltetheti ezeket a műveleteket, implementálhatja a IDeserializationCallback felületet, és csak akkor hajthatja végre a kódot, amikor visszahívják erre a felületre.

Konstruktorok

Name Description
ObjectManager(ISurrogateSelector, StreamingContext)

Inicializálja a ObjectManager osztály új példányát.

Metódusok

Name Description
DoFixups()

Elvégzi az összes rögzített javítást.
Equals(Object)

Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal.

(Öröklődés forrása Object)
GetHashCode()

Ez az alapértelmezett kivonatoló függvény.

(Öröklődés forrása Object)
GetObject(Int64)

A megadott objektumazonosítóval rendelkező objektumot adja vissza.
GetType()

Lekéri az Type aktuális példányt.

(Öröklődés forrása Object)
MemberwiseClone()

Az aktuális Objectpéldány sekély másolatát hozza létre.

(Öröklődés forrása Object)
RaiseDeserializationEvent()

A deszerializálási eseményt bármely olyan regisztrált objektumra emeli, amely megvalósítja IDeserializationCallbacka elemet.
RaiseOnDeserializingEvent(Object)

Meghívja a metódust, amely a OnDeserializingAttributekövetkezővel van megjelölve: .
RecordArrayElementFixup(Int64, Int32, Int64)

Egy tömb egyik eleméhez tartozó javítást rögzíti.
RecordArrayElementFixup(Int64, Int32[], Int64)

Rögzíti a tömb megadott elemeinek javításait, amelyeket később végre kell hajtani.
RecordDelayedFixup(Int64, String, Int64)

Rögzíti az objektumtagok javításait, amelyeket később végre kell hajtani.
RecordFixup(Int64, MemberInfo, Int64)

Rögzíti az objektum egy tagjának kijavítását, amely később lesz végrehajtva.
RegisterObject(Object, Int64, SerializationInfo, Int64, MemberInfo, Int32[])

Regisztrálja egy objektumban található tömb egy tagját, miközben deszerializálja, társítja a tömböt, objectIDés rögzíti a SerializationInfo.
RegisterObject(Object, Int64, SerializationInfo, Int64, MemberInfo)

Regisztrálja egy objektum egy tagját deszerializálva, társítva az objektummal objectID, és rögzíti a SerializationInfo.
RegisterObject(Object, Int64, SerializationInfo)

Regisztrál egy objektumot deszerializáltként, társítva azzal objectID, és rögzíti a SerializationInfo használt objektumot.
RegisterObject(Object, Int64)

Regisztrál egy objektumot deszerializáltként, társítva ezzel objectID.
ToString()

Az aktuális objektumot jelképező sztringet ad vissza.

(Öröklődés forrása Object)

A következőre érvényes: