ObjectManager.RegisterObject Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Inscrit un objet tel qu’il est désérialisé.
Surcharges
| Nom | Description |
|---|---|
| RegisterObject(Object, Int64) |
Inscrit un objet tel qu’il est désérialisé, l’associant à |
| RegisterObject(Object, Int64, SerializationInfo) |
Inscrit un objet tel qu’il est désérialisé, l’associant |
| RegisterObject(Object, Int64, SerializationInfo, Int64, MemberInfo) |
Inscrit un membre d’un objet tel qu’il est désérialisé, l’associant |
| RegisterObject(Object, Int64, SerializationInfo, Int64, MemberInfo, Int32[]) |
Inscrit un membre d’un tableau contenu dans un objet alors qu’il est désérialisé, l’associant |
RegisterObject(Object, Int64)
Inscrit un objet tel qu’il est désérialisé, l’associant à objectID.
public:
virtual void RegisterObject(System::Object ^ obj, long objectID);public virtual void RegisterObject(object obj, long objectID);[System.Security.SecurityCritical]
public virtual void RegisterObject(object obj, long objectID);abstract member RegisterObject : obj * int64 -> unit
override this.RegisterObject : obj * int64 -> unit[<System.Security.SecurityCritical>]
abstract member RegisterObject : obj * int64 -> unit
override this.RegisterObject : obj * int64 -> unitPublic Overridable Sub RegisterObject (obj As Object, objectID As Long)Paramètres
- obj
- Object
Objet à inscrire.
- objectID
- Int64
ID de l’objet à inscrire.
- Attributs
Exceptions
Le obj paramètre est null.
Le objectID paramètre est inférieur ou égal à zéro.
Le objectID fichier a déjà été inscrit pour un objet autre que obj.
Remarques
ObjectManager conserve des informations sur l’objet et son ID. Plus tard, lors de la désérialisation, GetObject vous pouvez l’utiliser pour déterminer si un ID d’objet particulier a déjà été désérialisé ou s’il s’agit d’une référence avant à un objet qui n’a pas encore été désérialisé.
S’applique à
RegisterObject(Object, Int64, SerializationInfo)
Inscrit un objet tel qu’il est désérialisé, l’associant objectIDà , et l’enregistrement de l’objet SerializationInfo utilisé.
public:
void RegisterObject(System::Object ^ obj, long objectID, System::Runtime::Serialization::SerializationInfo ^ info);public void RegisterObject(object obj, long objectID, System.Runtime.Serialization.SerializationInfo info);[System.Security.SecurityCritical]
public void RegisterObject(object obj, long objectID, System.Runtime.Serialization.SerializationInfo info);member this.RegisterObject : obj * int64 * System.Runtime.Serialization.SerializationInfo -> unit[<System.Security.SecurityCritical>]
member this.RegisterObject : obj * int64 * System.Runtime.Serialization.SerializationInfo -> unitPublic Sub RegisterObject (obj As Object, objectID As Long, info As SerializationInfo)Paramètres
- obj
- Object
Objet à inscrire.
- objectID
- Int64
ID de l’objet à inscrire.
- info
- SerializationInfo
Utilisé SerializationInfo si obj implémente ISerializable ou a un ISerializationSurrogate.
info est terminé avec toutes les informations de correction requises, puis transmises à l’objet requis une fois cet objet terminé.
- Attributs
Exceptions
Le obj paramètre est null.
Le objectID paramètre est inférieur ou égal à zéro.
Le objectID fichier a déjà été inscrit pour un objet autre que obj.
Remarques
ObjectManager conserve les informations relatives à l’objet et à son ID. Plus tard lors de la désérialisation, vous pouvez utiliser GetObject pour découvrir si un ID d’objet particulier a déjà été désérialisé ou s’il s’agit d’une référence vers un objet qui n’a pas encore été désérialisé.
S’applique à
RegisterObject(Object, Int64, SerializationInfo, Int64, MemberInfo)
Inscrit un membre d’un objet tel qu’il est désérialisé, l’associant objectIDà , et l’enregistrement du SerializationInfo.
public:
void RegisterObject(System::Object ^ obj, long objectID, System::Runtime::Serialization::SerializationInfo ^ info, long idOfContainingObj, System::Reflection::MemberInfo ^ member);public void RegisterObject(object obj, long objectID, System.Runtime.Serialization.SerializationInfo info, long idOfContainingObj, System.Reflection.MemberInfo member);[System.Security.SecurityCritical]
public void RegisterObject(object obj, long objectID, System.Runtime.Serialization.SerializationInfo info, long idOfContainingObj, System.Reflection.MemberInfo member);member this.RegisterObject : obj * int64 * System.Runtime.Serialization.SerializationInfo * int64 * System.Reflection.MemberInfo -> unit[<System.Security.SecurityCritical>]
member this.RegisterObject : obj * int64 * System.Runtime.Serialization.SerializationInfo * int64 * System.Reflection.MemberInfo -> unitPublic Sub RegisterObject (obj As Object, objectID As Long, info As SerializationInfo, idOfContainingObj As Long, member As MemberInfo)Paramètres
- obj
- Object
Objet à inscrire.
- objectID
- Int64
ID de l’objet à inscrire.
- info
- SerializationInfo
Utilisé SerializationInfo si obj implémente ISerializable ou a un ISerializationSurrogate.
info est terminé avec toutes les informations de correction requises, puis transmises à l’objet requis une fois cet objet terminé.
- idOfContainingObj
- Int64
ID de l’objet qui contient obj. Ce paramètre est obligatoire uniquement s’il obj s’agit d’un type valeur.
- member
- MemberInfo
Champ dans l’objet conteneur où obj il existe. Ce paramètre a une signification uniquement s’il s’agit obj d’un type valeur.
- Attributs
Exceptions
Le obj paramètre est null.
Le objectID paramètre est inférieur ou égal à zéro.
Le objectID fichier a déjà été inscrit pour un objet autre que obj, ou member n’est pas un FieldInfo et member n’est pas null.
Remarques
Vous devez fournir les paramètres et les member paramètres en objValueType raison de la façon dont les correctifs sont effectués sur ValueType les idOfContainingObj objets. L’espace permettant de stocker les informations d’un élément ValueType est alloué en ligne avec son objet conteneur. Toutefois, lorsque l’objet ValueType est boxé à inscrire auprès de celui-ci ObjectManager, il perd la connexion avec son objet conteneur. Pour garantir que les correctifs se produisent dans l’instance de l’objet ValueType stocké dans l’objet conteneur et non dans l’instance boxed, les ObjectManager informations supplémentaires sont conservées.
ObjectManager conserve des informations sur l’objet et son ID. Plus tard, lors de la désérialisation, GetObject vous pouvez l’utiliser pour découvrir si un ID d’objet particulier a déjà été désérialisé ou s’il s’agit d’une référence avant à un objet qui n’est pas encore désérialisé.
S’applique à
RegisterObject(Object, Int64, SerializationInfo, Int64, MemberInfo, Int32[])
Inscrit un membre d’un tableau contenu dans un objet alors qu’il est désérialisé, l’associant objectIDà , et enregistrant le SerializationInfo.
public:
void RegisterObject(System::Object ^ obj, long objectID, System::Runtime::Serialization::SerializationInfo ^ info, long idOfContainingObj, System::Reflection::MemberInfo ^ member, cli::array <int> ^ arrayIndex);public void RegisterObject(object obj, long objectID, System.Runtime.Serialization.SerializationInfo info, long idOfContainingObj, System.Reflection.MemberInfo member, int[] arrayIndex);[System.Security.SecurityCritical]
public void RegisterObject(object obj, long objectID, System.Runtime.Serialization.SerializationInfo info, long idOfContainingObj, System.Reflection.MemberInfo member, int[] arrayIndex);member this.RegisterObject : obj * int64 * System.Runtime.Serialization.SerializationInfo * int64 * System.Reflection.MemberInfo * int[] -> unit[<System.Security.SecurityCritical>]
member this.RegisterObject : obj * int64 * System.Runtime.Serialization.SerializationInfo * int64 * System.Reflection.MemberInfo * int[] -> unitPublic Sub RegisterObject (obj As Object, objectID As Long, info As SerializationInfo, idOfContainingObj As Long, member As MemberInfo, arrayIndex As Integer())Paramètres
- obj
- Object
Objet à inscrire.
- objectID
- Int64
ID de l’objet à inscrire.
- info
- SerializationInfo
Utilisé SerializationInfo si obj implémente ISerializable ou a un ISerializationSurrogate.
info est terminé avec toutes les informations de correction requises, puis transmises à l’objet requis une fois cet objet terminé.
- idOfContainingObj
- Int64
ID de l’objet qui contient obj. Ce paramètre est obligatoire uniquement s’il obj s’agit d’un type valeur.
- member
- MemberInfo
Champ dans l’objet conteneur où obj il existe. Ce paramètre a une signification uniquement s’il s’agit obj d’un type valeur.
- arrayIndex
- Int32[]
S’il obj s’agit d’un ValueType membre et d’un tableau, arrayIndex contient l’index dans ce tableau où obj il existe.
arrayIndex est ignoré si obj ce n’est pas à la fois un membre et un ValueType membre d’un tableau.
- Attributs
Exceptions
Le obj paramètre est null.
Le objectID paramètre est inférieur ou égal à zéro.
L’objet objectID a déjà été inscrit pour un objet autre que obj, ou member n’est pas un FieldInfo et member n’est pas null.
Remarques
Vous devez fournir les paramètres et les member paramètres en objValueType raison de la façon dont les correctifs sont effectués sur ValueType les idOfContainingObj objets. L’espace permettant de stocker les informations d’un élément ValueType est alloué en ligne avec son objet conteneur. Toutefois, lorsque l’objet ValueType est boxé à inscrire auprès de celui-ci ObjectManager, il perd la connexion avec son objet conteneur. Pour garantir que les correctifs se produisent dans l’instance de l’objet ValueType stocké dans l’objet conteneur et non dans l’instance boxed, les ObjectManager informations supplémentaires sont conservées.
ObjectManager conserve des informations sur l’objet et son ID. Plus tard, lors de la désérialisation, GetObject vous pouvez l’utiliser pour découvrir si un ID d’objet particulier a déjà été désérialisé ou s’il s’agit d’une référence avant à un objet qui n’est pas encore désérialisé.