SerializationInfo.AddValue Méthode

Définition

Espace de noms:: System.Runtime.Serialization

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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.

Ajoute une valeur dans le SerializationInfo.

Surcharges

Nom	Description
AddValue(String, Object, Type)	Ajoute une valeur dans le SerializationInfo magasin, où `value` est associé `name` et est sérialisé comme étant Type`type`.
AddValue(String, UInt64)	Ajoute une valeur entière non signée 64 bits dans le SerializationInfo magasin.
AddValue(String, UInt32)	Ajoute une valeur entière non signée 32 bits dans le SerializationInfo magasin.
AddValue(String, UInt16)	Ajoute une valeur entière non signée 16 bits dans le SerializationInfo magasin.
AddValue(String, Single)	Ajoute une valeur à virgule flottante simple précision dans le SerializationInfo magasin.
AddValue(String, SByte)	Ajoute une valeur entière signée 8 bits dans le SerializationInfo magasin.
AddValue(String, Object)	Ajoute l’objet spécifié dans le SerializationInfo magasin, où il est associé à un nom spécifié.
AddValue(String, Int64)	Ajoute une valeur entière signée 64 bits dans le SerializationInfo magasin.
AddValue(String, Int32)	Ajoute une valeur entière signée 32 bits dans le SerializationInfo magasin.
AddValue(String, Int16)	Ajoute une valeur entière signée 16 bits dans le SerializationInfo magasin.
AddValue(String, Double)	Ajoute une valeur à virgule flottante double précision dans le SerializationInfo magasin.
AddValue(String, Decimal)	Ajoute une valeur décimale dans le SerializationInfo magasin.
AddValue(String, DateTime)	Ajoute une DateTime valeur au SerializationInfo magasin.
AddValue(String, Char)	Ajoute une valeur de caractère Unicode dans le SerializationInfo magasin.
AddValue(String, Byte)	Ajoute une valeur entière non signée 8 bits dans le SerializationInfo magasin.
AddValue(String, Boolean)	Ajoute une valeur booléenne dans le SerializationInfo magasin.

AddValue(String, Object, Type)

Ajoute une valeur dans le SerializationInfo magasin, où value est associé name et est sérialisé comme étant Typetype.

public:
 void AddValue(System::String ^ name, System::Object ^ value, Type ^ type);

public void AddValue(string name, object value, Type type);

member this.AddValue : string * obj * Type -> unit

Public Sub AddValue (name As String, value As Object, type As Type)

Paramètres

name: String

Nom à associer à la valeur, afin qu’il puisse être désérialisé ultérieurement.

value: Object

Valeur à sérialiser. Tous les enfants de cet objet sont automatiquement sérialisés.

type: Type

À Type associer à l’objet actuel. Ce paramètre doit toujours être le type de l’objet lui-même ou de l’une de ses classes de base.

Exceptions

ArgumentNullException

Si name ou type est null.

SerializationException

Une valeur a déjà été associée à name.

Remarques

Le type affecté est toujours le type de l’objet, ou l’un de ses parents.

Si deux valeurs sont ajoutées avec des noms qui diffèrent uniquement par cas, aucune exception n’est levée, ce qui n’est pas une pratique recommandée. Toutefois, l’ajout de deux valeurs portant exactement le même nom entraîne la SerializationException levée.

S’applique à

AddValue(String, UInt64)

Important

Cette API n’est pas conforme CLS.

Ajoute une valeur entière non signée 64 bits dans le SerializationInfo magasin.

public:
 void AddValue(System::String ^ name, System::UInt64 value);

[System.CLSCompliant(false)]
public void AddValue(string name, ulong value);

[<System.CLSCompliant(false)>]
member this.AddValue : string * uint64 -> unit

Public Sub AddValue (name As String, value As ULong)

Paramètres

name: String

Nom à associer à la valeur, afin qu’il puisse être désérialisé ultérieurement.

value: UInt64

Valeur à sérialiser.

Attributs: CLSCompliantAttribute

Exceptions

ArgumentNullException

Le name paramètre est null.

SerializationException

Une valeur a déjà été associée à name.

Remarques

S’applique à

AddValue(String, UInt32)

Important

Cette API n’est pas conforme CLS.

Ajoute une valeur entière non signée 32 bits dans le SerializationInfo magasin.

public:
 void AddValue(System::String ^ name, System::UInt32 value);

[System.CLSCompliant(false)]
public void AddValue(string name, uint value);

[<System.CLSCompliant(false)>]
member this.AddValue : string * uint32 -> unit

Public Sub AddValue (name As String, value As UInteger)

Paramètres

name: String

Nom à associer à la valeur, afin qu’il puisse être désérialisé ultérieurement.

value: UInt32

Valeur UInt32 à sérialiser.

Attributs: CLSCompliantAttribute

Exceptions

ArgumentNullException

Le name paramètre est null.

SerializationException

Une valeur a déjà été associée à name.

Remarques

S’applique à

AddValue(String, UInt16)

Important

Cette API n’est pas conforme CLS.

Ajoute une valeur entière non signée 16 bits dans le SerializationInfo magasin.

public:
 void AddValue(System::String ^ name, System::UInt16 value);

[System.CLSCompliant(false)]
public void AddValue(string name, ushort value);

[<System.CLSCompliant(false)>]
member this.AddValue : string * uint16 -> unit

Public Sub AddValue (name As String, value As UShort)

Paramètres

name: String

Nom à associer à la valeur, afin qu’il puisse être désérialisé ultérieurement.

value: UInt16

Valeur UInt16 à sérialiser.

Attributs: CLSCompliantAttribute

Exceptions

ArgumentNullException

Le name paramètre est null.

SerializationException

Une valeur a déjà été associée à name.

Remarques

S’applique à

AddValue(String, Single)

Ajoute une valeur à virgule flottante simple précision dans le SerializationInfo magasin.

public:
 void AddValue(System::String ^ name, float value);

public void AddValue(string name, float value);

member this.AddValue : string * single -> unit

Public Sub AddValue (name As String, value As Single)

Paramètres

name: String

Nom à associer à la valeur, afin qu’il puisse être désérialisé ultérieurement.

value: Single

Valeur unique à sérialiser.

Exceptions

ArgumentNullException

Le name paramètre est null.

SerializationException

Une valeur a déjà été associée à name.

Remarques

S’applique à

AddValue(String, SByte)

Important

Cette API n’est pas conforme CLS.

Ajoute une valeur entière signée 8 bits dans le SerializationInfo magasin.

public:
 void AddValue(System::String ^ name, System::SByte value);

[System.CLSCompliant(false)]
public void AddValue(string name, sbyte value);

[<System.CLSCompliant(false)>]
member this.AddValue : string * sbyte -> unit

Public Sub AddValue (name As String, value As SByte)

Paramètres

name: String

Nom à associer à la valeur, afin qu’il puisse être désérialisé ultérieurement.

value: SByte

Valeur Sbyte à sérialiser.

Attributs: CLSCompliantAttribute

Exceptions

ArgumentNullException

Le name paramètre est null.

SerializationException

Une valeur a déjà été associée à name.

Remarques

S’applique à

AddValue(String, Object)

Ajoute l’objet spécifié dans le SerializationInfo magasin, où il est associé à un nom spécifié.

public:
 void AddValue(System::String ^ name, System::Object ^ value);

public void AddValue(string name, object value);

member this.AddValue : string * obj -> unit

Public Sub AddValue (name As String, value As Object)

Paramètres

name: String

Nom à associer à la valeur, afin qu’il puisse être désérialisé ultérieurement.

value: Object

Valeur à sérialiser. Tous les enfants de cet objet sont automatiquement sérialisés.

Exceptions

ArgumentNullException

name a la valeur null.

SerializationException

Une valeur a déjà été associée à name.

Remarques

L’objet contenu dans le value paramètre est sérialisé en tant que type retourné par value.

S’applique à

AddValue(String, Int64)

Ajoute une valeur entière signée 64 bits dans le SerializationInfo magasin.

public:
 void AddValue(System::String ^ name, long value);

public void AddValue(string name, long value);

member this.AddValue : string * int64 -> unit

Public Sub AddValue (name As String, value As Long)

Paramètres

name: String

Nom à associer à la valeur, afin qu’il puisse être désérialisé ultérieurement.

value: Int64

Valeur Int64 à sérialiser.

Exceptions

ArgumentNullException

Le name paramètre est null.

SerializationException

Une valeur a déjà été associée à name.

Remarques

S’applique à

AddValue(String, Int32)

Ajoute une valeur entière signée 32 bits dans le SerializationInfo magasin.

public:
 void AddValue(System::String ^ name, int value);

public void AddValue(string name, int value);

member this.AddValue : string * int -> unit

Public Sub AddValue (name As String, value As Integer)

Paramètres

name: String

Nom à associer à la valeur, afin qu’il puisse être désérialisé ultérieurement.

value: Int32

Valeur Int32 à sérialiser.

Exceptions

ArgumentNullException

Le name paramètre est null.

SerializationException

Une valeur a déjà été associée à name.

Remarques

S’applique à

AddValue(String, Int16)

Ajoute une valeur entière signée 16 bits dans le SerializationInfo magasin.

public:
 void AddValue(System::String ^ name, short value);

public void AddValue(string name, short value);

member this.AddValue : string * int16 -> unit

Public Sub AddValue (name As String, value As Short)

Paramètres

name: String

Nom à associer à la valeur, afin qu’il puisse être désérialisé ultérieurement.

value: Int16

Valeur Int16 à sérialiser.

Exceptions

ArgumentNullException

Le name paramètre est null.

SerializationException

Une valeur a déjà été associée à name.

Remarques

S’applique à

AddValue(String, Double)

Ajoute une valeur à virgule flottante double précision dans le SerializationInfo magasin.

public:
 void AddValue(System::String ^ name, double value);

public void AddValue(string name, double value);

member this.AddValue : string * double -> unit

Public Sub AddValue (name As String, value As Double)

Paramètres

name: String

Nom à associer à la valeur, afin qu’il puisse être désérialisé ultérieurement.

value: Double

Valeur double à sérialiser.

Exceptions

ArgumentNullException

Le name paramètre est null.

SerializationException

Une valeur a déjà été associée à name.

Remarques

S’applique à

AddValue(String, Decimal)

Ajoute une valeur décimale dans le SerializationInfo magasin.

public:
 void AddValue(System::String ^ name, System::Decimal value);

public void AddValue(string name, decimal value);

member this.AddValue : string * decimal -> unit

Public Sub AddValue (name As String, value As Decimal)

Paramètres

name: String

Nom à associer à la valeur, afin qu’il puisse être désérialisé ultérieurement.

value: Decimal

Valeur décimale à sérialiser.

Exceptions

ArgumentNullException

Si le name paramètre est null.

SerializationException

Si une valeur a déjà été associée à name.

Remarques

S’applique à

AddValue(String, DateTime)

Ajoute une DateTime valeur au SerializationInfo magasin.

public:
 void AddValue(System::String ^ name, DateTime value);

public void AddValue(string name, DateTime value);

member this.AddValue : string * DateTime -> unit

Public Sub AddValue (name As String, value As DateTime)

Paramètres

name: String

Nom à associer à la valeur, afin qu’il puisse être désérialisé ultérieurement.

value: DateTime

Valeur DateTime à sérialiser.

Exceptions

ArgumentNullException

Le name paramètre est null.

SerializationException

Une valeur a déjà été associée à name.

Remarques

S’applique à

AddValue(String, Char)

Ajoute une valeur de caractère Unicode dans le SerializationInfo magasin.

public:
 void AddValue(System::String ^ name, char value);

public void AddValue(string name, char value);

member this.AddValue : string * char -> unit

Public Sub AddValue (name As String, value As Char)

Paramètres

name: String

Nom à associer à la valeur, afin qu’il puisse être désérialisé ultérieurement.

value: Char

Valeur de caractère à sérialiser.

Exceptions

ArgumentNullException

Le name paramètre est null.

SerializationException

Une valeur a déjà été associée à name.

Remarques

S’applique à

AddValue(String, Byte)

Ajoute une valeur entière non signée 8 bits dans le SerializationInfo magasin.

public:
 void AddValue(System::String ^ name, System::Byte value);

public void AddValue(string name, byte value);

member this.AddValue : string * byte -> unit

Public Sub AddValue (name As String, value As Byte)

Paramètres

name: String

Nom à associer à la valeur, afin qu’il puisse être désérialisé ultérieurement.

value: Byte

Valeur d’octet à sérialiser.

Exceptions

ArgumentNullException

Le name paramètre est null.

SerializationException

Une valeur a déjà été associée à name.

Remarques

S’applique à

AddValue(String, Boolean)

Ajoute une valeur booléenne dans le SerializationInfo magasin.

public:
 void AddValue(System::String ^ name, bool value);

public void AddValue(string name, bool value);

member this.AddValue : string * bool -> unit

Public Sub AddValue (name As String, value As Boolean)

Paramètres

name: String

Nom à associer à la valeur, afin qu’il puisse être désérialisé ultérieurement.

value: Boolean

Valeur booléenne à sérialiser.

Exceptions

ArgumentNullException

Le name paramètre est null.

SerializationException

Une valeur a déjà été associée à name.

Remarques

void ISerializable.GetObject(SerializationInfo info, StreamingContext context)
{
   // This will not cause an exception to be thrown.
   info.AddValue("ABC", true);
   info.AddValue("abc", false);
   // However, this will cause the SerializationException to be thrown.
   info.AddValue("XYZ", true);
   info.AddValue("XYZ", false);
}

Private Sub GetObjectData(ByVal info As SerializationInfo, _
ByVal context As StreamingContext)
   ' This will not cause an exception to be thrown.
   info.AddValue("ABC", "upper case")
   info.AddValue("abc", "lower case")
   ' However, this will cause the SerializationException to be thrown.
   info.AddValue("XYZ", "same case")
   info.AddValue("XYZ", "same case")
End Sub

S’applique à

Commentaires

Cette page a-t-elle été utile ?