SerializationInfo.AddValue Méthode

  • Référence

Définition

Espace de noms:
System.Runtime.Serialization
Assembly:
System.Runtime.dll
Assembly:
System.Runtime.Serialization.Formatters.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Ajoute une valeur dans SerializationInfo.

Surcharges

AddValue(String, Object, Type)

Ajoute une valeur dans le magasin SerializationInfo, où value est associé à name et est sérialisé en tant que Typetype.
AddValue(String, UInt64)

Ajoute une valeur d’entier 64 bits non signé dans le magasin SerializationInfo.
AddValue(String, UInt32)

Ajoute une valeur d’entier 32 bits non signé dans le magasin SerializationInfo.
AddValue(String, UInt16)

Ajoute une valeur entière 16 bits non signée dans le magasin SerializationInfo.
AddValue(String, Single)

Ajoute une valeur à virgule flottante simple précision dans le magasin SerializationInfo.
AddValue(String, SByte)

Ajoute une valeur entière 8 bits signée dans le magasin SerializationInfo.
AddValue(String, Object)

Ajoute l'objet spécifié dans le magasin SerializationInfo, où il est associé à un nom spécifié.
AddValue(String, Int64)

Ajoute une valeur d’entier 64 bits signé dans le magasin SerializationInfo.
AddValue(String, Int32)

Ajoute une valeur d’entier 32 bits signé dans le magasin SerializationInfo.
AddValue(String, Int16)

Ajoute une valeur entière 16 bits signée dans le magasin SerializationInfo.
AddValue(String, Double)

Ajoute une valeur à virgule flottante double précision dans le magasin SerializationInfo.
AddValue(String, Decimal)

Ajoute une valeur décimale dans le magasin SerializationInfo.
AddValue(String, DateTime)

Ajoute une valeur DateTime dans le magasin SerializationInfo.
AddValue(String, Char)

Ajoute une valeur des caractères Unicode dans le magasin SerializationInfo.
AddValue(String, Byte)

Ajoute une valeur entière 8 bits non signée dans le magasin SerializationInfo.
AddValue(String, Boolean)

Ajoute une valeur booléenne au magasin SerializationInfo.

AddValue(String, Object, Type)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
Source:
SerializationInfo.cs

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

public:
 void AddValue(System::String ^ name, System::Object ^ value, Type ^ type);
public void AddValue (string name, 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, de sorte qu'elle puisse être désérialisée ultérieurement.

value
Object

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

type
Type

Type à associer à l'objet en cours. Ce paramètre doit toujours être le type de l'objet lui-même ou 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 la casse, 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 levée de SerializationException .

S’applique à

AddValue(String, UInt64)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
Source:
SerializationInfo.cs

Important

Cette API n’est pas conforme CLS.

Ajoute une valeur d’entier 64 bits non signé dans le magasin SerializationInfo.

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, de sorte qu'elle puisse être désérialisée ultérieurement.

value
UInt64

Valeur à sérialiser.

Attributs
CLSCompliantAttribute

Exceptions

ArgumentNullException

Le paramètre name a la valeur null.

SerializationException

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

Remarques

Si deux valeurs sont ajoutées avec des noms qui diffèrent uniquement par la casse, 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 levée de SerializationException .

S’applique à

AddValue(String, UInt32)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
Source:
SerializationInfo.cs

Important

Cette API n’est pas conforme CLS.

Ajoute une valeur d’entier 32 bits non signé dans le magasin SerializationInfo.

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, de sorte qu'elle puisse être désérialisée ultérieurement.

value
UInt32

Valeur UInt32 à sérialiser.

Attributs
CLSCompliantAttribute

Exceptions

ArgumentNullException

Le paramètre name a la valeur null.

SerializationException

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

Remarques

Si deux valeurs sont ajoutées avec des noms qui diffèrent uniquement par la casse, 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 levée de SerializationException .

S’applique à

AddValue(String, UInt16)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
Source:
SerializationInfo.cs

Important

Cette API n’est pas conforme CLS.

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

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, de sorte qu'elle puisse être désérialisée ultérieurement.

value
UInt16

Valeur UInt16 à sérialiser.

Attributs
CLSCompliantAttribute

Exceptions

ArgumentNullException

Le paramètre name a la valeur null.

SerializationException

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

Remarques

Si deux valeurs sont ajoutées avec des noms qui diffèrent uniquement par la casse, 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 levée de SerializationException .

S’applique à

AddValue(String, Single)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
Source:
SerializationInfo.cs

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

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, de sorte qu'elle puisse être désérialisée ultérieurement.

value
Single

Valeur simple à sérialiser.

Exceptions

ArgumentNullException

Le paramètre name a la valeur null.

SerializationException

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

Remarques

Si deux valeurs sont ajoutées avec des noms qui diffèrent uniquement par la casse, 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 levée de SerializationException .

S’applique à

AddValue(String, SByte)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
Source:
SerializationInfo.cs

Important

Cette API n’est pas conforme CLS.

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

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, de sorte qu'elle puisse être désérialisée ultérieurement.

value
SByte

Valeur Sbyte à sérialiser.

Attributs
CLSCompliantAttribute

Exceptions

ArgumentNullException

Le paramètre name a la valeur null.

SerializationException

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

Remarques

Si deux valeurs sont ajoutées avec des noms qui diffèrent uniquement par la casse, 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 levée de SerializationException .

S’applique à

AddValue(String, Object)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
Source:
SerializationInfo.cs

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

public:
 void AddValue(System::String ^ name, System::Object ^ value);
public void AddValue (string name, 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, de sorte qu'elle puisse être désérialisée ultérieurement.

value
Object

Valeur à sérialiser. 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.

Si deux valeurs sont ajoutées avec des noms qui diffèrent uniquement par la casse, 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 levée de SerializationException .

S’applique à

AddValue(String, Int64)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
Source:
SerializationInfo.cs

Ajoute une valeur d’entier 64 bits signé dans le magasin SerializationInfo.

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, de sorte qu'elle puisse être désérialisée ultérieurement.

value
Int64

Valeur de type Int64 à sérialiser.

Exceptions

ArgumentNullException

Le paramètre name a la valeur null.

SerializationException

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

Remarques

Si deux valeurs sont ajoutées avec des noms qui diffèrent uniquement par la casse, 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 levée de SerializationException .

S’applique à

AddValue(String, Int32)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
Source:
SerializationInfo.cs

Ajoute une valeur d’entier 32 bits signé dans le magasin SerializationInfo.

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, de sorte qu'elle puisse être désérialisée ultérieurement.

value
Int32

Valeur Int32 à sérialiser.

Exceptions

ArgumentNullException

Le paramètre name a la valeur null.

SerializationException

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

Remarques

Si deux valeurs sont ajoutées avec des noms qui diffèrent uniquement par la casse, 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 levée de SerializationException .

S’applique à

AddValue(String, Int16)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
Source:
SerializationInfo.cs

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

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, de sorte qu'elle puisse être désérialisée ultérieurement.

value
Int16

Valeur Int16 à sérialiser.

Exceptions

ArgumentNullException

Le paramètre name a la valeur null.

SerializationException

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

Remarques

Si deux valeurs sont ajoutées avec des noms qui diffèrent uniquement par la casse, 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 levée de SerializationException .

S’applique à

AddValue(String, Double)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
Source:
SerializationInfo.cs

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

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, de sorte qu'elle puisse être désérialisée ultérieurement.

value
Double

Valeur double à sérialiser.

Exceptions

ArgumentNullException

Le paramètre name a la valeur null.

SerializationException

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

Remarques

Si deux valeurs sont ajoutées avec des noms qui diffèrent uniquement par la casse, 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 levée de SerializationException .

S’applique à

AddValue(String, Decimal)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
Source:
SerializationInfo.cs

Ajoute une valeur décimale dans le magasin SerializationInfo.

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, de sorte qu'elle puisse être désérialisée ultérieurement.

value
Decimal

Valeur décimale à sérialiser.

Exceptions

ArgumentNullException

Si le paramètre name est null.

SerializationException

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

Remarques

Si deux valeurs sont ajoutées avec des noms qui diffèrent uniquement par la casse, 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 levée de SerializationException .

S’applique à

AddValue(String, DateTime)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
Source:
SerializationInfo.cs

Ajoute une valeur DateTime dans le magasin SerializationInfo.

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, de sorte qu'elle puisse être désérialisée ultérieurement.

value
DateTime

Valeur DateTime à sérialiser.

Exceptions

ArgumentNullException

Le paramètre name a la valeur null.

SerializationException

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

Remarques

Si deux valeurs sont ajoutées avec des noms qui diffèrent uniquement par la casse, 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 levée de SerializationException .

S’applique à

AddValue(String, Char)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
Source:
SerializationInfo.cs

Ajoute une valeur des caractères Unicode dans le magasin SerializationInfo.

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, de sorte qu'elle puisse être désérialisée ultérieurement.

value
Char

Valeur de caractère à sérialiser.

Exceptions

ArgumentNullException

Le paramètre name a la valeur null.

SerializationException

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

Remarques

Si deux valeurs sont ajoutées avec des noms qui diffèrent uniquement par la casse, 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 levée de SerializationException .

S’applique à

AddValue(String, Byte)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
Source:
SerializationInfo.cs

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

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, de sorte qu'elle puisse être désérialisée ultérieurement.

value
Byte

Valeur de type octet à sérialiser.

Exceptions

ArgumentNullException

Le paramètre name a la valeur null.

SerializationException

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

Remarques

Si deux valeurs sont ajoutées avec des noms qui diffèrent uniquement par la casse, 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 levée de SerializationException .

S’applique à

AddValue(String, Boolean)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
Source:
SerializationInfo.cs

Ajoute une valeur booléenne au magasin SerializationInfo.

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, de sorte qu'elle puisse être désérialisée ultérieurement.

value
Boolean

Valeur booléenne à sérialiser.

Exceptions

ArgumentNullException

Le paramètre name a la valeur null.

SerializationException

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

Remarques

Si deux valeurs sont ajoutées avec des noms qui diffèrent uniquement par la casse, 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 levée de SerializationException . Exemple :

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 à