SerializationInfo.AddValue Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Agrega un valor a SerializationInfo.
Sobrecargas
| AddValue(String, Object, Type) |
Agrega un valor al almacén SerializationInfo, donde |
| 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 -> unitPublic 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 -> unitPublic 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 -> unitPublic 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.
- 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 -> unitPublic 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.
- 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 -> unitPublic 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 -> unitPublic 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 -> unitPublic 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 -> unitPublic 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 -> unitPublic 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.
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 -> unitPublic 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.
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 -> unitPublic 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 -> unitPublic 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 -> unitPublic 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.
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 -> unitPublic 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 -> unitPublic 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 -> unitPublic 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
