SerializationInfo.AddValue Método

Definición

Espacio de nombres:

System.Runtime.Serialization

Ensamblado:

System.Runtime.dll

Agrega un valor a SerializationInfo.

Sobrecargas

AddValue(String, Object, Type)	Agrega un valor al almacén SerializationInfo, donde value está asociado a name y se serializa con Typetype.
AddValue(String, UInt64)	Agrega un valor entero de 64 bits sin signo al almacén SerializationInfo.
AddValue(String, UInt32)	Agrega un valor entero de 32 bits sin signo al almacén SerializationInfo.
AddValue(String, UInt16)	Agrega un valor entero de 16 bits sin signo al almacén SerializationInfo.
AddValue(String, Single)	Agrega un valor de punto flotante de precisión sencilla al almacén SerializationInfo.
AddValue(String, SByte)	Agrega un valor entero de 8 bits con signo al almacén SerializationInfo.
AddValue(String, Object)	Agrega el objeto especificado al almacén SerializationInfo, donde se le asocia un nombre especificado.
AddValue(String, Int64)	Agrega un valor entero de 64 bits con signo al almacén SerializationInfo.
AddValue(String, Int32)	Agrega un valor entero de 32 bits con signo al almacén SerializationInfo.
AddValue(String, Int16)	Agrega un valor entero de 16 bits con signo al almacén SerializationInfo.
AddValue(String, Double)	Agrega un valor de punto flotante de precisión doble al almacén SerializationInfo.
AddValue(String, Decimal)	Agrega un valor decimal al almacén SerializationInfo.
AddValue(String, DateTime)	Agrega un valor DateTime al almacén SerializationInfo.
AddValue(String, Char)	Agrega un valor de carácter Unicode al almacén SerializationInfo.
AddValue(String, Byte)	Agrega un valor entero de 8 bits sin signo al almacén SerializationInfo.
AddValue(String, Boolean)	Agrega un valor booleano al almacén SerializationInfo.

AddValue(String, Object, Type)

Source:

SerializationInfo.cs

Agrega un valor al almacén SerializationInfo, donde value está asociado a name y se serializa con 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)

Parámetros

name

String

Nombre que se asocia al valor de modo que se pueda deserializar posteriormente.

value

Object

Valor que se va a serializar. Automáticamente se serializarán todos los elementos secundarios de este objeto.

type

Type

Type que se va a asociar al objeto actual. Este parámetro debe ser siempre el tipo del objeto en sí o una de sus clases base.

Excepciones

ArgumentNullException

Si name o type es null.

SerializationException

Ya se ha asociado un valor a name.

Comentarios

El tipo asignado siempre es el tipo del objeto o uno de sus elementos primarios.

Si se agregan dos valores con nombres que solo difieren por caso, no se producirá ninguna excepción, que no es una práctica recomendada. Sin embargo, agregar dos valores con el mismo nombre hará SerializationException que se inicie .

AddValue(String, UInt64)

Source:

SerializationInfo.cs

Importante

Esta API no es conforme a CLS.

Agrega un valor entero de 64 bits sin signo al almacén 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)

Parámetros

name

String

Nombre que se asocia al valor de modo que se pueda deserializar posteriormente.

value

UInt64

Valor que se va a serializar.

Atributos

CLSCompliantAttribute

Excepciones

ArgumentNullException

El parámetro name es null.

SerializationException

Ya se ha asociado un valor a name.

Comentarios

Si se agregan dos valores con nombres que solo difieren por caso, no se producirá ninguna excepción, que no es una práctica recomendada. Sin embargo, agregar dos valores con el mismo nombre hará SerializationException que se inicie .

AddValue(String, UInt32)

Source:

SerializationInfo.cs

Importante

Esta API no es conforme a CLS.

Agrega un valor entero de 32 bits sin signo al almacén 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)

Parámetros

name

String

Nombre que se asocia al valor de modo que se pueda deserializar posteriormente.

value

UInt32

Valor UInt32 que se va a serializar.

Atributos

CLSCompliantAttribute

Excepciones

ArgumentNullException

El parámetro name es null.

SerializationException

Ya se ha asociado un valor a name.

Comentarios

Si se agregan dos valores con nombres que solo difieren por caso, no se producirá ninguna excepción, que no es una práctica recomendada. Sin embargo, agregar dos valores con el mismo nombre hará SerializationException que se inicie .

AddValue(String, UInt16)

Source:

SerializationInfo.cs

Importante

Esta API no es conforme a CLS.

Agrega un valor entero de 16 bits sin signo al almacén 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)

Parámetros

name

String

Nombre que se asocia al valor de modo que se pueda deserializar posteriormente.

value

UInt16

Valor UInt16 que se va a serializar.

Atributos

CLSCompliantAttribute

Excepciones

ArgumentNullException

El parámetro name es null.

SerializationException

Ya se ha asociado un valor a name.

Comentarios

Si se agregan dos valores con nombres que solo difieren por caso, no se producirá ninguna excepción, que no es una práctica recomendada. Sin embargo, agregar dos valores con el mismo nombre hará SerializationException que se inicie .

AddValue(String, Single)

Source:

SerializationInfo.cs

Agrega un valor de punto flotante de precisión sencilla al almacén 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)

Parámetros

name

String

Nombre que se asocia al valor de modo que se pueda deserializar posteriormente.

value

Single

Valor single que se va a serializar.

Excepciones

ArgumentNullException

El parámetro name es null.

SerializationException

Ya se ha asociado un valor a name.

Comentarios

Si se agregan dos valores con nombres que solo difieren por caso, no se producirá ninguna excepción, que no es una práctica recomendada. Sin embargo, agregar dos valores con el mismo nombre hará SerializationException que se inicie .

AddValue(String, SByte)

Source:

SerializationInfo.cs

Importante

Esta API no es conforme a CLS.

Agrega un valor entero de 8 bits con signo al almacén 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)

Parámetros

name

String

Nombre que se asocia al valor de modo que se pueda deserializar posteriormente.

value

SByte

Valor Sbyte que se va a serializar.

Atributos

CLSCompliantAttribute

Excepciones

ArgumentNullException

El parámetro name es null.

SerializationException

Ya se ha asociado un valor a name.

Comentarios

Si se agregan dos valores con nombres que solo difieren por caso, no se producirá ninguna excepción, que no es una práctica recomendada. Sin embargo, agregar dos valores con el mismo nombre hará SerializationException que se inicie .

AddValue(String, Object)

Source:

SerializationInfo.cs

Agrega el objeto especificado al almacén SerializationInfo, donde se le asocia un nombre especificado.

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)

Parámetros

name

String

Nombre que se asocia al valor de modo que se pueda deserializar posteriormente.

value

Object

Valor que se va a serializar. Automáticamente se serializarán todos los elementos secundarios de este objeto.

Excepciones

ArgumentNullException

name es null.

SerializationException

Ya se ha asociado un valor a name.

Comentarios

El objeto contenido en el value parámetro se serializa como el tipo devuelto por value.

Si se agregan dos valores con nombres que solo difieren por caso, no se producirá ninguna excepción, que no es una práctica recomendada. Sin embargo, agregar dos valores con el mismo nombre hará SerializationException que se inicie .

AddValue(String, Int64)

Source:

SerializationInfo.cs

Agrega un valor entero de 64 bits con signo al almacén 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)

Parámetros

name

String

Nombre que se asocia al valor de modo que se pueda deserializar posteriormente.

value

Int64

Valor Int64 que se va a serializar.

Excepciones

ArgumentNullException

El parámetro name es null.

SerializationException

Ya se ha asociado un valor a name.

Comentarios

Si se agregan dos valores con nombres que solo difieren por caso, no se producirá ninguna excepción, que no es una práctica recomendada. Sin embargo, agregar dos valores con el mismo nombre hará SerializationException que se inicie .

AddValue(String, Int32)

Source:

SerializationInfo.cs

Agrega un valor entero de 32 bits con signo al almacén 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)

Parámetros

name

String

Nombre que se asocia al valor de modo que se pueda deserializar posteriormente.

value

Int32

Valor Int32 que se va a serializar.

Excepciones

ArgumentNullException

El parámetro name es null.

SerializationException

Ya se ha asociado un valor a name.

Comentarios

Si se agregan dos valores con nombres que solo difieren por mayúsculas y minúsculas, no se producirá ninguna excepción, que no es una práctica recomendada. Sin embargo, agregar dos valores con el mismo nombre hará que se inicie .SerializationException

AddValue(String, Int16)

Source:

SerializationInfo.cs

Agrega un valor entero de 16 bits con signo al almacén 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)

Parámetros

name

String

Nombre que se asocia al valor de modo que se pueda deserializar posteriormente.

value

Int16

Valor Int16 que se va a serializar.

Excepciones

ArgumentNullException

El parámetro name es null.

SerializationException

Ya se ha asociado un valor a name.

Comentarios

Si se agregan dos valores con nombres que solo difieren por mayúsculas y minúsculas, no se producirá ninguna excepción, que no es una práctica recomendada. Sin embargo, agregar dos valores con el mismo nombre hará que se inicie .SerializationException

AddValue(String, Double)

Source:

SerializationInfo.cs

Agrega un valor de punto flotante de precisión doble al almacén 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)

Parámetros

name

String

Nombre que se asocia al valor de modo que se pueda deserializar posteriormente.

value

Double

Valor double que se va a serializar.

Excepciones

ArgumentNullException

El parámetro name es null.

SerializationException

Ya se ha asociado un valor a name.

Comentarios

Si se agregan dos valores con nombres que solo difieren por mayúsculas y minúsculas, no se producirá ninguna excepción, que no es una práctica recomendada. Sin embargo, agregar dos valores con el mismo nombre hará que se inicie .SerializationException

AddValue(String, Decimal)

Source:

SerializationInfo.cs

Agrega un valor decimal al almacén 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)

Parámetros

name

String

Nombre que se asocia al valor de modo que se pueda deserializar posteriormente.

value

Decimal

Valor decimal que se va a serializar.

Excepciones

ArgumentNullException

Si el parámetro name es null.

SerializationException

Si ya se ha asociado un valor a name.

Comentarios

Si se agregan dos valores con nombres que solo difieren por mayúsculas y minúsculas, no se producirá ninguna excepción, que no es una práctica recomendada. Sin embargo, agregar dos valores con el mismo nombre hará que se inicie .SerializationException

AddValue(String, DateTime)

Source:

SerializationInfo.cs

Agrega un valor DateTime al almacén 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)

Parámetros

name

String

Nombre que se asocia al valor de modo que se pueda deserializar posteriormente.

value

DateTime

Valor DateTime que se va a serializar.

Excepciones

ArgumentNullException

El parámetro name es null.

SerializationException

Ya se ha asociado un valor a name.

Comentarios

Si se agregan dos valores con nombres que solo difieren por mayúsculas y minúsculas, no se producirá ninguna excepción, que no es una práctica recomendada. Sin embargo, agregar dos valores con el mismo nombre hará que se inicie .SerializationException

AddValue(String, Char)

Source:

SerializationInfo.cs

Agrega un valor de carácter Unicode al almacén 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)

Parámetros

name

String

Nombre que se asocia al valor de modo que se pueda deserializar posteriormente.

value

Char

Valor de carácter que se va a serializar.

Excepciones

ArgumentNullException

El parámetro name es null.

SerializationException

Ya se ha asociado un valor a name.

Comentarios

Si se agregan dos valores con nombres que solo difieren por mayúsculas y minúsculas, no se producirá ninguna excepción, que no es una práctica recomendada. Sin embargo, agregar dos valores con el mismo nombre hará que se inicie .SerializationException

AddValue(String, Byte)

Source:

SerializationInfo.cs

Agrega un valor entero de 8 bits sin signo al almacén 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)

Parámetros

name

String

Nombre que se asocia al valor de modo que se pueda deserializar posteriormente.

value

Byte

Valor de byte que se va a serializar.

Excepciones

ArgumentNullException

El parámetro name es null.

SerializationException

Ya se ha asociado un valor a name.

Comentarios

Si se agregan dos valores con nombres que solo difieren por mayúsculas y minúsculas, no se producirá ninguna excepción, que no es una práctica recomendada. Sin embargo, agregar dos valores con el mismo nombre hará que se inicie .SerializationException

AddValue(String, Boolean)

Source:

SerializationInfo.cs

Agrega un valor booleano al almacén 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)

Parámetros

name

String

Nombre que se asocia al valor de modo que se pueda deserializar posteriormente.

value

Boolean

Valor booleano que se va a serializar.

Excepciones

ArgumentNullException

El parámetro name es null.

SerializationException

Ya se ha asociado un valor a name.

Comentarios

Si se agregan dos valores con nombres que solo difieren por mayúsculas y minúsculas, no se producirá ninguna excepción, que no es una práctica recomendada. Sin embargo, agregar dos valores con el mismo nombre hará que se inicie .SerializationException Por ejemplo:

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