SerializationInfo.AddValue Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Adiciona um valor ao SerializationInfo.
Sobrecargas
| Nome | Description |
|---|---|
| AddValue(String, Object, Type) |
Adiciona um valor ao SerializationInfo repositório, onde |
| AddValue(String, UInt64) |
Adiciona um valor inteiro sem sinal de 64 bits ao repositório SerializationInfo . |
| AddValue(String, UInt32) |
Adiciona um valor inteiro sem sinal de 32 bits ao repositório SerializationInfo . |
| AddValue(String, UInt16) |
Adiciona um valor inteiro sem sinal de 16 bits ao repositório SerializationInfo . |
| AddValue(String, Single) |
Adiciona um valor de ponto flutuante de precisão única ao repositório SerializationInfo . |
| AddValue(String, SByte) |
Adiciona um valor inteiro com sinal de 8 bits ao repositório SerializationInfo . |
| AddValue(String, Object) |
Adiciona o objeto especificado ao SerializationInfo repositório, no qual ele está associado a um nome especificado. |
| AddValue(String, Int64) |
Adiciona um valor inteiro com sinal de 64 bits ao repositório SerializationInfo . |
| AddValue(String, Int32) |
Adiciona um valor inteiro com sinal de 32 bits ao repositório SerializationInfo . |
| AddValue(String, Int16) |
Adiciona um valor inteiro com sinal de 16 bits ao repositório SerializationInfo . |
| AddValue(String, Double) |
Adiciona um valor de ponto flutuante de precisão dupla ao repositório SerializationInfo . |
| AddValue(String, Decimal) |
Adiciona um valor decimal ao repositório SerializationInfo . |
| AddValue(String, DateTime) |
Adiciona um DateTime valor ao repositório SerializationInfo . |
| AddValue(String, Char) |
Adiciona um valor de caractere Unicode ao repositório SerializationInfo . |
| AddValue(String, Byte) |
Adiciona um valor inteiro sem sinal de 8 bits ao repositório SerializationInfo . |
| AddValue(String, Boolean) |
Adiciona um valor booliano ao repositório SerializationInfo . |
AddValue(String, Object, Type)
Adiciona um valor ao SerializationInfo repositório, onde value está associado name e é serializado como sendo .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 -> unitPublic Sub AddValue (name As String, value As Object, type As Type)Parâmetros
- name
- String
O nome a ser associado ao valor, para que ele possa ser desserializado posteriormente.
- value
- Object
O valor a ser serializado. Todos os filhos desse objeto serão serializados automaticamente.
- type
- Type
O Type objeto a ser associado ao objeto atual. Esse parâmetro deve ser sempre o tipo do próprio objeto ou de uma de suas classes base.
Exceções
Se name ou type for null.
Um valor já foi associado namea .
Comentários
O tipo atribuído é sempre o tipo do objeto ou um de seus pais.
Se dois valores forem adicionados com nomes que diferem apenas por caso, nenhuma exceção será gerada, o que não é uma prática recomendada. No entanto, a adição de dois valores com o mesmo nome fará com que eles SerializationException sejam gerados.
Aplica-se a
AddValue(String, UInt64)
Importante
Esta API não está em conformidade com CLS.
Adiciona um valor inteiro sem sinal de 64 bits ao repositório 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
O nome a ser associado ao valor, para que ele possa ser desserializado posteriormente.
- value
- UInt64
O valor a ser serializado.
- Atributos
Exceções
O name parâmetro é null.
Um valor já foi associado namea .
Comentários
Se dois valores forem adicionados com nomes que diferem apenas por caso, nenhuma exceção será gerada, o que não é uma prática recomendada. No entanto, a adição de dois valores com o mesmo nome fará com que eles SerializationException sejam gerados.
Aplica-se a
AddValue(String, UInt32)
Importante
Esta API não está em conformidade com CLS.
Adiciona um valor inteiro sem sinal de 32 bits ao repositório 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
O nome a ser associado ao valor, para que ele possa ser desserializado posteriormente.
- Atributos
Exceções
O name parâmetro é null.
Um valor já foi associado namea .
Comentários
Se dois valores forem adicionados com nomes que diferem apenas por caso, nenhuma exceção será gerada, o que não é uma prática recomendada. No entanto, a adição de dois valores com o mesmo nome fará com que eles SerializationException sejam gerados.
Aplica-se a
AddValue(String, UInt16)
Importante
Esta API não está em conformidade com CLS.
Adiciona um valor inteiro sem sinal de 16 bits ao repositório 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
O nome a ser associado ao valor, para que ele possa ser desserializado posteriormente.
- Atributos
Exceções
O name parâmetro é null.
Um valor já foi associado namea .
Comentários
Se dois valores forem adicionados com nomes que diferem apenas por caso, nenhuma exceção será gerada, o que não é uma prática recomendada. No entanto, a adição de dois valores com o mesmo nome fará com que eles SerializationException sejam gerados.
Aplica-se a
AddValue(String, Single)
Adiciona um valor de ponto flutuante de precisão única ao repositório 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
O nome a ser associado ao valor, para que ele possa ser desserializado posteriormente.
- value
- Single
O valor único a ser serializado.
Exceções
O name parâmetro é null.
Um valor já foi associado namea .
Comentários
Se dois valores forem adicionados com nomes que diferem apenas por caso, nenhuma exceção será gerada, o que não é uma prática recomendada. No entanto, a adição de dois valores com o mesmo nome fará com que eles SerializationException sejam gerados.
Aplica-se a
AddValue(String, SByte)
Importante
Esta API não está em conformidade com CLS.
Adiciona um valor inteiro com sinal de 8 bits ao repositório 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
O nome a ser associado ao valor, para que ele possa ser desserializado posteriormente.
- value
- SByte
O Sbyte valor a ser serializado.
- Atributos
Exceções
O name parâmetro é null.
Um valor já foi associado namea .
Comentários
Se dois valores forem adicionados com nomes que diferem apenas por caso, nenhuma exceção será gerada, o que não é uma prática recomendada. No entanto, a adição de dois valores com o mesmo nome fará com que eles SerializationException sejam gerados.
Aplica-se a
AddValue(String, Object)
Adiciona o objeto especificado ao SerializationInfo repositório, no qual ele está associado a um nome especificado.
public:
void AddValue(System::String ^ name, System::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
O nome a ser associado ao valor, para que ele possa ser desserializado posteriormente.
- value
- Object
O valor a ser serializado. Todos os filhos desse objeto serão serializados automaticamente.
Exceções
name é null.
Um valor já foi associado namea .
Comentários
O objeto contido no value parâmetro é serializado como o tipo retornado por value.
Se dois valores forem adicionados com nomes que diferem apenas por caso, nenhuma exceção será gerada, o que não é uma prática recomendada. No entanto, a adição de dois valores com o mesmo nome fará com que eles SerializationException sejam gerados.
Aplica-se a
AddValue(String, Int64)
Adiciona um valor inteiro com sinal de 64 bits ao repositório 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
O nome a ser associado ao valor, para que ele possa ser desserializado posteriormente.
- value
- Int64
O valor Int64 a ser serializado.
Exceções
O name parâmetro é null.
Um valor já foi associado namea .
Comentários
Se dois valores forem adicionados com nomes que diferem apenas por caso, nenhuma exceção será gerada, o que não é uma prática recomendada. No entanto, a adição de dois valores com o mesmo nome fará com que eles SerializationException sejam gerados.
Aplica-se a
AddValue(String, Int32)
Adiciona um valor inteiro com sinal de 32 bits ao repositório 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
O nome a ser associado ao valor, para que ele possa ser desserializado posteriormente.
Exceções
O name parâmetro é null.
Um valor já foi associado namea .
Comentários
Se dois valores forem adicionados com nomes que diferem apenas por caso, nenhuma exceção será gerada, o que não é uma prática recomendada. No entanto, a adição de dois valores com o mesmo nome fará com que eles SerializationException sejam gerados.
Aplica-se a
AddValue(String, Int16)
Adiciona um valor inteiro com sinal de 16 bits ao repositório 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
O nome a ser associado ao valor, para que ele possa ser desserializado posteriormente.
Exceções
O name parâmetro é null.
Um valor já foi associado namea .
Comentários
Se dois valores forem adicionados com nomes que diferem apenas por caso, nenhuma exceção será gerada, o que não é uma prática recomendada. No entanto, a adição de dois valores com o mesmo nome fará com que eles SerializationException sejam gerados.
Aplica-se a
AddValue(String, Double)
Adiciona um valor de ponto flutuante de precisão dupla ao repositório 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
O nome a ser associado ao valor, para que ele possa ser desserializado posteriormente.
- value
- Double
O valor duplo a ser serializado.
Exceções
O name parâmetro é null.
Um valor já foi associado namea .
Comentários
Se dois valores forem adicionados com nomes que diferem apenas por caso, nenhuma exceção será gerada, o que não é uma prática recomendada. No entanto, a adição de dois valores com o mesmo nome fará com que eles SerializationException sejam gerados.
Aplica-se a
AddValue(String, Decimal)
Adiciona um valor decimal ao repositório 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
O nome a ser associado ao valor, para que ele possa ser desserializado posteriormente.
- value
- Decimal
O valor decimal a ser serializado.
Exceções
Se o name parâmetro for null.
Se um valor já tiver sido associado namea .
Comentários
Se dois valores forem adicionados com nomes que diferem apenas por caso, nenhuma exceção será gerada, o que não é uma prática recomendada. No entanto, a adição de dois valores com o mesmo nome fará com que eles SerializationException sejam gerados.
Aplica-se a
AddValue(String, DateTime)
Adiciona um DateTime valor ao repositório 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
O nome a ser associado ao valor, para que ele possa ser desserializado posteriormente.
Exceções
O name parâmetro é null.
Um valor já foi associado namea .
Comentários
Se dois valores forem adicionados com nomes que diferem apenas por caso, nenhuma exceção será gerada, o que não é uma prática recomendada. No entanto, a adição de dois valores com o mesmo nome fará com que eles SerializationException sejam gerados.
Aplica-se a
AddValue(String, Char)
Adiciona um valor de caractere Unicode ao repositório 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
O nome a ser associado ao valor, para que ele possa ser desserializado posteriormente.
- value
- Char
O valor do caractere a ser serializado.
Exceções
O name parâmetro é null.
Um valor já foi associado namea .
Comentários
Se dois valores forem adicionados com nomes que diferem apenas por caso, nenhuma exceção será gerada, o que não é uma prática recomendada. No entanto, a adição de dois valores com o mesmo nome fará com que eles SerializationException sejam gerados.
Aplica-se a
AddValue(String, Byte)
Adiciona um valor inteiro sem sinal de 8 bits ao repositório 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
O nome a ser associado ao valor, para que ele possa ser desserializado posteriormente.
- value
- Byte
O valor de byte a ser serializado.
Exceções
O name parâmetro é null.
Um valor já foi associado namea .
Comentários
Se dois valores forem adicionados com nomes que diferem apenas por caso, nenhuma exceção será gerada, o que não é uma prática recomendada. No entanto, a adição de dois valores com o mesmo nome fará com que eles SerializationException sejam gerados.
Aplica-se a
AddValue(String, Boolean)
Adiciona um valor booliano ao repositório 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
O nome a ser associado ao valor, para que ele possa ser desserializado posteriormente.
- value
- Boolean
O valor booliano a ser serializado.
Exceções
O name parâmetro é null.
Um valor já foi associado namea .
Comentários
Se dois valores forem adicionados com nomes que diferem apenas por caso, nenhuma exceção será gerada, o que não é uma prática recomendada. No entanto, a adição de dois valores com o mesmo nome fará com que eles SerializationException sejam gerados. Por exemplo:
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