Freigeben über


ObjectIDGenerator-Klasse

Generiert IDs für Objekte.

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

Syntax

'Declaration
<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class ObjectIDGenerator
'Usage
Dim instance As ObjectIDGenerator
[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public class ObjectIDGenerator
[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class ObjectIDGenerator
/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public class ObjectIDGenerator
SerializableAttribute 
ComVisibleAttribute(true) 
public class ObjectIDGenerator

Hinweise

Der ObjectIDGenerator verfolgt zuvor bezeichnete Objekte. Wenn die ID eines Objekts angefordert wird, gibt der ObjectIDGenerator die ID, sofern vorhanden, zurück oder generiert und speichert eine neue ID.

Während der Lebensdauer der ObjectIDGenerator-Instanz sind die IDs eindeutig. Die Lebensdauer eines ObjectIDGenerator entspricht im Allgemeinen der Lebensdauer des Formatter, durch den er erstellt wurde. Objekt-IDs sind nur innerhalb eines angegebenen serialisierten Streams von Bedeutung. Sie werden eingesetzt, um zu verfolgen, welche Objekte Verweise auf andere Objekte innerhalb des serialisierten Objektdiagramms enthalten.

Der ObjectIDGenerator speichert die Zuweisungen von IDs zu Objekten anhand einer Hashtabelle. Die jedes Objekt eindeutig kennzeichnenden Objektverweise sind Adressen im von der Garbage Collection freigegebenen Laufzeit-Heap. Werte von Objektverweisen können sich während der Serialisierung ändern. Die Tabelle wird jedoch automatisch aktualisiert, um die Richtigkeit der Daten zu gewährleisten.

Objekt-IDs sind 64-Bit-Zahlen. Die Zuordnung beginnt bei eins, daher kann 0 (null) keine gültige Objekt-ID sein. Ein Formatierungsprogramm kann mit dem Wert 0 (null) einen Objektverweis mit dem Wert NULL (Nothing in Visual Basic) darstellen.

Vererbungshierarchie

System.Object
  System.Runtime.Serialization.ObjectIDGenerator

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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

ObjectIDGenerator-Member
System.Runtime.Serialization-Namespace
Formatter-Klasse

Weitere Ressourcen

XML- und SOAP-Serialisierung