SerializationInfo.AddValue Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Aggiunge un valore in SerializationInfo.
Overload
| Nome | Descrizione |
|---|---|
| AddValue(String, Object, Type) |
Aggiunge un valore nell'archivio SerializationInfo , dove |
| 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 valore intero senza segno a 16 bit nell'archivio SerializationInfo . |
| AddValue(String, Single) |
Aggiunge un valore a virgola mobile e precisione singola nell'archivio SerializationInfo . |
| AddValue(String, SByte) |
Aggiunge un valore intero con segno a 8 bit nell'archivio SerializationInfo . |
| AddValue(String, Object) |
Aggiunge l'oggetto specificato nell'archivio SerializationInfo , dove è 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 valore intero con segno a 16 bit nell'archivio SerializationInfo . |
| AddValue(String, Double) |
Aggiunge un valore a virgola mobile e precisione doppia nell'archivio SerializationInfo . |
| AddValue(String, Decimal) |
Aggiunge un valore decimale nell'archivio SerializationInfo . |
| AddValue(String, DateTime) |
Aggiunge un DateTime valore nell'archivio SerializationInfo . |
| AddValue(String, Char) |
Aggiunge un valore carattere Unicode nell'archivio SerializationInfo . |
| AddValue(String, Byte) |
Aggiunge un valore intero senza segno a 8 bit nell'archivio SerializationInfo . |
| AddValue(String, Boolean) |
Aggiunge un valore booleano nell'archivio SerializationInfo . |
AddValue(String, Object, Type)
Aggiunge un valore nell'archivio SerializationInfo , dove value è associato a name e viene serializzato come di 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, in modo che possa essere deserializzato in un secondo momento.
- value
- Object
Valore da serializzare. Tutti gli elementi figlio di questo oggetto verranno serializzati automaticamente.
- type
- Type
Oggetto Type da associare all'oggetto corrente. Questo parametro deve essere sempre il tipo dell'oggetto stesso o di una delle relative classi di base.
Eccezioni
Se name o type è null.
Un valore è già stato associato a name.
Commenti
Il tipo assegnato è sempre il tipo dell'oggetto o uno dei relativi elementi padre.
Se vengono aggiunti due valori con nomi diversi solo per caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà l'eccezione SerializationException da generare.
Si applica a
AddValue(String, UInt64)
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, in modo che possa essere deserializzato in un secondo momento.
- value
- UInt64
Valore da serializzare.
- Attributi
Eccezioni
Il name parametro è null.
Un valore è già stato associato a name.
Commenti
Se vengono aggiunti due valori con nomi diversi solo per caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà l'eccezione SerializationException da generare.
Si applica a
AddValue(String, UInt32)
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, in modo che possa essere deserializzato in un secondo momento.
- Attributi
Eccezioni
Il name parametro è null.
Un valore è già stato associato a name.
Commenti
Se vengono aggiunti due valori con nomi diversi solo per caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà l'eccezione SerializationException da generare.
Si applica a
AddValue(String, UInt16)
Importante
Questa API non è conforme a CLS.
Aggiunge un valore 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, in modo che possa essere deserializzato in un secondo momento.
- Attributi
Eccezioni
Il name parametro è null.
Un valore è già stato associato a name.
Commenti
Se vengono aggiunti due valori con nomi diversi solo per caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà l'eccezione SerializationException da generare.
Si applica a
AddValue(String, Single)
Aggiunge un valore a 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, in modo che possa essere deserializzato in un secondo momento.
- value
- Single
Valore singolo da serializzare.
Eccezioni
Il name parametro è null.
Un valore è già stato associato a name.
Commenti
Se vengono aggiunti due valori con nomi diversi solo per caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà l'eccezione SerializationException da generare.
Si applica a
AddValue(String, SByte)
Importante
Questa API non è conforme a CLS.
Aggiunge un valore 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, in modo che possa essere deserializzato in un secondo momento.
- value
- SByte
Valore Sbyte da serializzare.
- Attributi
Eccezioni
Il name parametro è null.
Un valore è già stato associato a name.
Commenti
Se vengono aggiunti due valori con nomi diversi solo per caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà l'eccezione SerializationException da generare.
Si applica a
AddValue(String, Object)
Aggiunge l'oggetto specificato nell'archivio SerializationInfo , dove è 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, in modo che possa essere deserializzato in un secondo momento.
- value
- Object
Valore da serializzare. Tutti gli elementi figlio di questo oggetto verranno serializzati automaticamente.
Eccezioni
name è null.
Un valore è già stato associato a name.
Commenti
L'oggetto contenuto nel value parametro viene serializzato come tipo restituito da value.
Se vengono aggiunti due valori con nomi diversi solo per caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà l'eccezione SerializationException da generare.
Si applica a
AddValue(String, Int64)
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, in modo che possa essere deserializzato in un secondo momento.
- value
- Int64
Valore Int64 da serializzare.
Eccezioni
Il name parametro è null.
Un valore è già stato associato a name.
Commenti
Se vengono aggiunti due valori con nomi diversi solo per caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà l'eccezione SerializationException da generare.
Si applica a
AddValue(String, Int32)
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, in modo che possa essere deserializzato in un secondo momento.
Eccezioni
Il name parametro è null.
Un valore è già stato associato a name.
Commenti
Se vengono aggiunti due valori con nomi diversi solo per caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà l'eccezione SerializationException da generare.
Si applica a
AddValue(String, Int16)
Aggiunge un valore 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, in modo che possa essere deserializzato in un secondo momento.
Eccezioni
Il name parametro è null.
Un valore è già stato associato a name.
Commenti
Se vengono aggiunti due valori con nomi diversi solo per caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà l'eccezione SerializationException da generare.
Si applica a
AddValue(String, Double)
Aggiunge un valore a 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, in modo che possa essere deserializzato in un secondo momento.
- value
- Double
Valore double da serializzare.
Eccezioni
Il name parametro è null.
Un valore è già stato associato a name.
Commenti
Se vengono aggiunti due valori con nomi diversi solo per caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà l'eccezione SerializationException da generare.
Si applica a
AddValue(String, Decimal)
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, in modo che possa essere deserializzato in un secondo momento.
- value
- Decimal
Valore decimale da serializzare.
Eccezioni
Se il name parametro è null.
Se un valore è già stato associato a name.
Commenti
Se vengono aggiunti due valori con nomi diversi solo per caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà l'eccezione SerializationException da generare.
Si applica a
AddValue(String, DateTime)
Aggiunge un DateTime valore 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, in modo che possa essere deserializzato in un secondo momento.
Eccezioni
Il name parametro è null.
Un valore è già stato associato a name.
Commenti
Se vengono aggiunti due valori con nomi diversi solo per caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà l'eccezione SerializationException da generare.
Si applica a
AddValue(String, Char)
Aggiunge un valore 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, in modo che possa essere deserializzato in un secondo momento.
- value
- Char
Valore del carattere da serializzare.
Eccezioni
Il name parametro è null.
Un valore è già stato associato a name.
Commenti
Se vengono aggiunti due valori con nomi diversi solo per caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà l'eccezione SerializationException da generare.
Si applica a
AddValue(String, Byte)
Aggiunge un valore 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, in modo che possa essere deserializzato in un secondo momento.
- value
- Byte
Valore di byte da serializzare.
Eccezioni
Il name parametro è null.
Un valore è già stato associato a name.
Commenti
Se vengono aggiunti due valori con nomi diversi solo per caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà l'eccezione SerializationException da generare.
Si applica a
AddValue(String, Boolean)
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, in modo che possa essere deserializzato in un secondo momento.
- value
- Boolean
Valore booleano da serializzare.
Eccezioni
Il name parametro è null.
Un valore è già stato associato a name.
Commenti
Se vengono aggiunti due valori con nomi diversi solo per caso, non verrà generata alcuna eccezione, che non è una procedura consigliata. Tuttavia, l'aggiunta di due valori con lo stesso nome causerà l'eccezione SerializationException da generare. Per 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