SerializationInfo.AddValue Metodo

Definizione

Spazio dei nomi:

System.Runtime.Serialization

Assembly:

System.Runtime.dll

Aggiunge un valore in SerializationInfo.

Overload

AddValue(String, Object, Type)	Aggiunge un valore nell'archivio SerializationInfo, dove value è associato a name ed è serializzato come di tipo Typetype.
AddValue(String, UInt64)	Aggiunge un valore intero senza segno a 64 bit nell'archivio SerializationInfo.
AddValue(String, UInt32)	Aggiunge un valore intero senza segno a 32 bit nell'archivio SerializationInfo.
AddValue(String, UInt16)	Aggiunge un intero senza segno a 16 bit nell'archivio SerializationInfo.
AddValue(String, Single)	Aggiunge un valore in virgola mobile e precisione singola nell'archivio SerializationInfo.
AddValue(String, SByte)	Aggiunge un intero con segno a 8 bit nell'archivio SerializationInfo.
AddValue(String, Object)	Aggiunge l'oggetto specificato nell'archivio SerializationInfo, in cui è associato a un nome specificato.
AddValue(String, Int64)	Aggiunge un valore intero con segno a 64 bit nell'archivio SerializationInfo.
AddValue(String, Int32)	Aggiunge un valore intero con segno a 32 bit nell'archivio SerializationInfo.
AddValue(String, Int16)	Aggiunge un intero con segno a 16 bit nell'archivio SerializationInfo.
AddValue(String, Double)	Aggiunge un valore in virgola mobile e precisione doppia nell'archivio SerializationInfo.
AddValue(String, Decimal)	Aggiunge un valore decimale nell'archivio SerializationInfo.
AddValue(String, DateTime)	Aggiunge un valore DateTime nell'archivio SerializationInfo.
AddValue(String, Char)	Aggiunge un valore di carattere Unicode nell'archivio SerializationInfo.
AddValue(String, Byte)	Aggiunge un intero senza segno a 8 bit nell'archivio SerializationInfo.
AddValue(String, Boolean)	Aggiunge un valore booleano nell'archivio SerializationInfo.

AddValue(String, Object, Type)

Origine:

SerializationInfo.cs

Aggiunge un valore nell'archivio SerializationInfo, dove value è associato a name ed è serializzato come di tipo 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)

Parametri

name

String

Nome da associare al valore per consentirne la successiva deserializzazione.

value

Object

Valore da serializzare. Eventuali figli di questo oggetto verranno serializzati automaticamente.

type

Type

Type da associare all'oggetto corrente. Questo parametro deve sempre corrispondere al tipo dell'oggetto o di una delle relative classi base.

Eccezioni

ArgumentNullException

Se name o type è null.

SerializationException

Al parametro name è già stato associato un valore.

Commenti

Il tipo assegnato è sempre il tipo dell'oggetto o uno dei relativi genitori.

Se vengono aggiunti due valori con nomi diversi solo in base al caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà la creazione dell'oggetto SerializationException .

AddValue(String, UInt64)

Origine:

SerializationInfo.cs

Importante

Questa API non è conforme a CLS.

Aggiunge un valore intero senza segno a 64 bit nell'archivio 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)

Parametri

name

String

Nome da associare al valore per consentirne la successiva deserializzazione.

value

UInt64

Valore da serializzare.

Attributi

CLSCompliantAttribute

Eccezioni

ArgumentNullException

Il valore del parametro name è null.

SerializationException

Al parametro name è già stato associato un valore.

Commenti

Se vengono aggiunti due valori con nomi diversi solo in base al caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà la creazione dell'oggetto SerializationException .

AddValue(String, UInt32)

Origine:

SerializationInfo.cs

Importante

Questa API non è conforme a CLS.

Aggiunge un valore intero senza segno a 32 bit nell'archivio 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)

Parametri

name

String

Nome da associare al valore per consentirne la successiva deserializzazione.

value

UInt32

Valore UInt32 da serializzare.

Attributi

CLSCompliantAttribute

Eccezioni

ArgumentNullException

Il valore del parametro name è null.

SerializationException

Al parametro name è già stato associato un valore.

Commenti

Se vengono aggiunti due valori con nomi diversi solo in base al caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà la creazione dell'oggetto SerializationException .

AddValue(String, UInt16)

Origine:

SerializationInfo.cs

Importante

Questa API non è conforme a CLS.

Aggiunge un intero senza segno a 16 bit nell'archivio 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)

Parametri

name

String

Nome da associare al valore per consentirne la successiva deserializzazione.

value

UInt16

Valore UInt16 da serializzare.

Attributi

CLSCompliantAttribute

Eccezioni

ArgumentNullException

Il valore del parametro name è null.

SerializationException

Al parametro name è già stato associato un valore.

Commenti

Se vengono aggiunti due valori con nomi diversi solo in base al caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà la creazione dell'oggetto SerializationException .

AddValue(String, Single)

Origine:

SerializationInfo.cs

Aggiunge un valore in virgola mobile e precisione singola nell'archivio 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)

Parametri

name

String

Nome da associare al valore per consentirne la successiva deserializzazione.

value

Single

Valore Single da serializzare.

Eccezioni

ArgumentNullException

Il valore del parametro name è null.

SerializationException

Al parametro name è già stato associato un valore.

Commenti

Se vengono aggiunti due valori con nomi diversi solo in base al caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà la creazione dell'oggetto SerializationException .

AddValue(String, SByte)

Origine:

SerializationInfo.cs

Importante

Questa API non è conforme a CLS.

Aggiunge un intero con segno a 8 bit nell'archivio 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)

Parametri

name

String

Nome da associare al valore per consentirne la successiva deserializzazione.

value

SByte

Valore Sbyte da serializzare.

Attributi

CLSCompliantAttribute

Eccezioni

ArgumentNullException

Il valore del parametro name è null.

SerializationException

Al parametro name è già stato associato un valore.

Commenti

Se vengono aggiunti due valori con nomi diversi solo in base al caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà la creazione dell'oggetto SerializationException .

AddValue(String, Object)

Origine:

SerializationInfo.cs

Aggiunge l'oggetto specificato nell'archivio SerializationInfo, in cui è associato a un nome specificato.

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)

Parametri

name

String

Nome da associare al valore per consentirne la successiva deserializzazione.

value

Object

Valore da serializzare. Eventuali figli di questo oggetto verranno serializzati automaticamente.

Eccezioni

ArgumentNullException

name è null.

SerializationException

Al parametro name è già stato associato un valore.

Commenti

L'oggetto value contenuto nel parametro viene serializzato come tipo restituito da value.

Se vengono aggiunti due valori con nomi diversi solo in base al caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà la creazione dell'oggetto SerializationException .

AddValue(String, Int64)

Origine:

SerializationInfo.cs

Aggiunge un valore intero con segno a 64 bit nell'archivio 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)

Parametri

name

String

Nome da associare al valore per consentirne la successiva deserializzazione.

value

Int64

Valore Int64 da serializzare.

Eccezioni

ArgumentNullException

Il valore del parametro name è null.

SerializationException

Al parametro name è già stato associato un valore.

Commenti

Se vengono aggiunti due valori con nomi diversi solo in base al caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà la creazione dell'oggetto SerializationException .

AddValue(String, Int32)

Origine:

SerializationInfo.cs

Aggiunge un valore intero con segno a 32 bit nell'archivio 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)

Parametri

name

String

Nome da associare al valore per consentirne la successiva deserializzazione.

value

Int32

Valore Int32 da serializzare.

Eccezioni

ArgumentNullException

Il valore del parametro name è null.

SerializationException

Al parametro name è già stato associato un valore.

Commenti

Se vengono aggiunti due valori con nomi diversi solo in base al caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà la creazione dell'oggetto SerializationException .

AddValue(String, Int16)

Origine:

SerializationInfo.cs

Aggiunge un intero con segno a 16 bit nell'archivio 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)

Parametri

name

String

Nome da associare al valore per consentirne la successiva deserializzazione.

value

Int16

Valore Int16 da serializzare.

Eccezioni

ArgumentNullException

Il valore del parametro name è null.

SerializationException

Al parametro name è già stato associato un valore.

Commenti

Se vengono aggiunti due valori con nomi diversi solo in base al caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà la creazione dell'oggetto SerializationException .

AddValue(String, Double)

Origine:

SerializationInfo.cs

Aggiunge un valore in virgola mobile e precisione doppia nell'archivio 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)

Parametri

name

String

Nome da associare al valore per consentirne la successiva deserializzazione.

value

Double

Valore Double da serializzare.

Eccezioni

ArgumentNullException

Il valore del parametro name è null.

SerializationException

Al parametro name è già stato associato un valore.

Commenti

Se vengono aggiunti due valori con nomi diversi solo in base al caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà la creazione dell'oggetto SerializationException .

AddValue(String, Decimal)

Origine:

SerializationInfo.cs

Aggiunge un valore decimale nell'archivio 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)

Parametri

name

String

Nome da associare al valore per consentirne la successiva deserializzazione.

value

Decimal

Valore decimale da serializzare.

Eccezioni

ArgumentNullException

Il valore del parametro name è null.

SerializationException

A name è già stato associato un valore.

Commenti

Se vengono aggiunti due valori con nomi diversi solo in base al caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà la creazione dell'oggetto SerializationException .

AddValue(String, DateTime)

Origine:

SerializationInfo.cs

Aggiunge un valore DateTime nell'archivio 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)

Parametri

name

String

Nome da associare al valore per consentirne la successiva deserializzazione.

value

DateTime

Valore DateTime da serializzare.

Eccezioni

ArgumentNullException

Il valore del parametro name è null.

SerializationException

Al parametro name è già stato associato un valore.

Commenti

Se vengono aggiunti due valori con nomi diversi solo in base al caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà la creazione dell'oggetto SerializationException .

AddValue(String, Char)

Origine:

SerializationInfo.cs

Aggiunge un valore di carattere Unicode nell'archivio 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)

Parametri

name

String

Nome da associare al valore per consentirne la successiva deserializzazione.

value

Char

Valore del carattere da serializzare.

Eccezioni

ArgumentNullException

Il valore del parametro name è null.

SerializationException

Al parametro name è già stato associato un valore.

Commenti

Se vengono aggiunti due valori con nomi diversi solo in base al caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà la creazione dell'oggetto SerializationException .

AddValue(String, Byte)

Origine:

SerializationInfo.cs

Aggiunge un intero senza segno a 8 bit nell'archivio 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)

Parametri

name

String

Nome da associare al valore per consentirne la successiva deserializzazione.

value

Byte

Valore di byte da serializzare.

Eccezioni

ArgumentNullException

Il valore del parametro name è null.

SerializationException

Al parametro name è già stato associato un valore.

Commenti

Se vengono aggiunti due valori con nomi diversi solo in base al caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà la creazione dell'oggetto SerializationException .

AddValue(String, Boolean)

Origine:

SerializationInfo.cs

Aggiunge un valore booleano nell'archivio 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)

Parametri

name

String

Nome da associare al valore per consentirne la successiva deserializzazione.

value

Boolean

Valore booleano da serializzare.

Eccezioni

ArgumentNullException

Il valore del parametro name è null.

SerializationException

Al parametro name è già stato associato un valore.

Commenti

Se vengono aggiunti due valori con nomi diversi solo in base al caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà la creazione dell'oggetto SerializationException . Ad esempio:

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