Comparteix a través de


SerializationInfo.AddValue Método

Definición

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
Source:
SerializationInfo.cs
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);
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

Si name o type es null.

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 .

Se aplica a

AddValue(String, UInt64)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
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

Excepciones

El parámetro name es null.

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 .

Se aplica a

AddValue(String, UInt32)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
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

Excepciones

El parámetro name es null.

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 .

Se aplica a

AddValue(String, UInt16)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
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

Excepciones

El parámetro name es null.

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 .

Se aplica a

AddValue(String, Single)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
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

El parámetro name es null.

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 .

Se aplica a

AddValue(String, SByte)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
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

Excepciones

El parámetro name es null.

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 .

Se aplica a

AddValue(String, Object)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
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);
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

name es null.

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 .

Se aplica a

AddValue(String, Int64)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
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

El parámetro name es null.

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 .

Se aplica a

AddValue(String, Int32)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
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

El parámetro name es null.

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

Se aplica a

AddValue(String, Int16)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
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

El parámetro name es null.

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

Se aplica a

AddValue(String, Double)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
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

El parámetro name es null.

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

Se aplica a

AddValue(String, Decimal)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
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

Si el parámetro name es null.

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

Se aplica a

AddValue(String, DateTime)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
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

El parámetro name es null.

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

Se aplica a

AddValue(String, Char)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
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

El parámetro name es null.

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

Se aplica a

AddValue(String, Byte)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
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

El parámetro name es null.

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

Se aplica a

AddValue(String, Boolean)

Source:
SerializationInfo.cs
Source:
SerializationInfo.cs
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

El parámetro name es null.

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  

Se aplica a