SerializationInfo.AddValue Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Acrescenta um valor ao SerializationInfo.
Sobrecargas
| Name | Description |
|---|---|
| AddValue(String, Object, Type) |
Adiciona um valor à SerializationInfo loja, onde |
| AddValue(String, UInt64) |
Adiciona um valor inteiro sem sinal de 64 bits à SerializationInfo loja. |
| AddValue(String, UInt32) |
Adiciona um valor inteiro não assinado de 32 bits à SerializationInfo loja. |
| AddValue(String, UInt16) |
Adiciona um valor inteiro não assinado de 16 bits à SerializationInfo loja. |
| AddValue(String, Single) |
Adiciona um valor de ponto flutuante de precisão simples à SerializationInfo loja. |
| AddValue(String, SByte) |
Adiciona um valor inteiro assinado de 8 bits ao SerializationInfo armazenamento. |
| AddValue(String, Object) |
Adiciona o objeto especificado à SerializationInfo loja, onde está associado a um nome especificado. |
| AddValue(String, Int64) |
Adiciona um valor inteiro assinado de 64 bits à SerializationInfo loja. |
| AddValue(String, Int32) |
Adiciona um valor inteiro assinado de 32 bits à SerializationInfo memória. |
| AddValue(String, Int16) |
Adiciona um valor inteiro assinado de 16 bits ao SerializationInfo armazenamento. |
| AddValue(String, Double) |
Adiciona um valor de ponto flutuante de dupla precisão à SerializationInfo loja. |
| AddValue(String, Decimal) |
Adiciona um valor decimal à SerializationInfo loja. |
| AddValue(String, DateTime) |
Acrescenta valor DateTime à SerializationInfo loja. |
| AddValue(String, Char) |
Adiciona um valor de carácter Unicode à SerializationInfo loja. |
| AddValue(String, Byte) |
Adiciona um valor inteiro não assinado de 8 bits à SerializationInfo loja. |
| AddValue(String, Boolean) |
Adiciona um valor booleano à SerializationInfo loja. |
AddValue(String, Object, Type)
Adiciona um valor à SerializationInfo loja, onde value está associado a name e é serializado como sendo de 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 associar ao valor, para que possa ser desserializado mais tarde.
- value
- Object
O valor a serializar. Quaisquer filhos deste objeto serão automaticamente serializados.
- type
- Type
O Type para associar ao objeto atual. Este parâmetro deve ser sempre o tipo do próprio objeto ou de uma das suas classes base.
Exceções
Se name ou type for null.
Um valor já foi associado a name.
Observações
O tipo atribuído é sempre o tipo do objeto, ou de um dos seus pais.
Se dois valores forem somados com nomes que diferem apenas por caso, não será feita exceção, o que não é uma prática recomendada. No entanto, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja lançado.
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 à SerializationInfo loja.
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 associar ao valor, para que possa ser desserializado mais tarde.
- value
- UInt64
O valor de serializar.
- Atributos
Exceções
O name parâmetro é null.
Um valor já foi associado a name.
Observações
Se dois valores forem somados com nomes que diferem apenas por caso, não será feita exceção, o que não é uma prática recomendada. No entanto, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja lançado.
Aplica-se a
AddValue(String, UInt32)
Importante
Esta API não está em conformidade com CLS.
Adiciona um valor inteiro não assinado de 32 bits à SerializationInfo loja.
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 associar ao valor, para que possa ser desserializado mais tarde.
- Atributos
Exceções
O name parâmetro é null.
Um valor já foi associado a name.
Observações
Se dois valores forem somados com nomes que diferem apenas por caso, não será feita exceção, o que não é uma prática recomendada. No entanto, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja lançado.
Aplica-se a
AddValue(String, UInt16)
Importante
Esta API não está em conformidade com CLS.
Adiciona um valor inteiro não assinado de 16 bits à SerializationInfo loja.
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 associar ao valor, para que possa ser desserializado mais tarde.
- Atributos
Exceções
O name parâmetro é null.
Um valor já foi associado a name.
Observações
Se dois valores forem somados com nomes que diferem apenas por caso, não será feita exceção, o que não é uma prática recomendada. No entanto, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja lançado.
Aplica-se a
AddValue(String, Single)
Adiciona um valor de ponto flutuante de precisão simples à SerializationInfo loja.
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 associar ao valor, para que possa ser desserializado mais tarde.
- value
- Single
O único valor a serializar.
Exceções
O name parâmetro é null.
Um valor já foi associado a name.
Observações
Se dois valores forem somados com nomes que diferem apenas por caso, não será feita exceção, o que não é uma prática recomendada. No entanto, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja lançado.
Aplica-se a
AddValue(String, SByte)
Importante
Esta API não está em conformidade com CLS.
Adiciona um valor inteiro assinado de 8 bits ao SerializationInfo armazenamento.
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 associar ao valor, para que possa ser desserializado mais tarde.
- value
- SByte
O Sbyte valor de serializar.
- Atributos
Exceções
O name parâmetro é null.
Um valor já foi associado a name.
Observações
Se dois valores forem somados com nomes que diferem apenas por caso, não será feita exceção, o que não é uma prática recomendada. No entanto, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja lançado.
Aplica-se a
AddValue(String, Object)
Adiciona o objeto especificado à SerializationInfo loja, onde 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 associar ao valor, para que possa ser desserializado mais tarde.
- value
- Object
O valor a serializar. Quaisquer filhos deste objeto serão automaticamente serializados.
Exceções
name é null.
Um valor já foi associado a name.
Observações
O objeto contido no value parâmetro é serializado como o tipo devolvido por value.
Se dois valores forem somados com nomes que diferem apenas por caso, não será feita exceção, o que não é uma prática recomendada. No entanto, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja lançado.
Aplica-se a
AddValue(String, Int64)
Adiciona um valor inteiro assinado de 64 bits à SerializationInfo loja.
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 associar ao valor, para que possa ser desserializado mais tarde.
- value
- Int64
O valor Int64 para serializar.
Exceções
O name parâmetro é null.
Um valor já foi associado a name.
Observações
Se dois valores forem somados com nomes que diferem apenas por caso, não será feita exceção, o que não é uma prática recomendada. No entanto, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja lançado.
Aplica-se a
AddValue(String, Int32)
Adiciona um valor inteiro assinado de 32 bits à SerializationInfo memória.
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 associar ao valor, para que possa ser desserializado mais tarde.
Exceções
O name parâmetro é null.
Um valor já foi associado a name.
Observações
Se dois valores forem somados com nomes que diferem apenas por caso, não será feita exceção, o que não é uma prática recomendada. No entanto, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja lançado.
Aplica-se a
AddValue(String, Int16)
Adiciona um valor inteiro assinado de 16 bits ao SerializationInfo armazenamento.
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 associar ao valor, para que possa ser desserializado mais tarde.
Exceções
O name parâmetro é null.
Um valor já foi associado a name.
Observações
Se dois valores forem somados com nomes que diferem apenas por caso, não será feita exceção, o que não é uma prática recomendada. No entanto, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja lançado.
Aplica-se a
AddValue(String, Double)
Adiciona um valor de ponto flutuante de dupla precisão à SerializationInfo loja.
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 associar ao valor, para que possa ser desserializado mais tarde.
- value
- Double
O valor duplo a serializar.
Exceções
O name parâmetro é null.
Um valor já foi associado a name.
Observações
Se dois valores forem somados com nomes que diferem apenas por caso, não será feita exceção, o que não é uma prática recomendada. No entanto, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja lançado.
Aplica-se a
AddValue(String, Decimal)
Adiciona um valor decimal à SerializationInfo loja.
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 associar ao valor, para que possa ser desserializado mais tarde.
- value
- Decimal
O valor decimal a serializar.
Exceções
Se O name parâmetro for null.
Se um valor já foi associado a name.
Observações
Se dois valores forem somados com nomes que diferem apenas por caso, não será feita exceção, o que não é uma prática recomendada. No entanto, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja lançado.
Aplica-se a
AddValue(String, DateTime)
Acrescenta valor DateTime à SerializationInfo loja.
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 associar ao valor, para que possa ser desserializado mais tarde.
Exceções
O name parâmetro é null.
Um valor já foi associado a name.
Observações
Se dois valores forem somados com nomes que diferem apenas por caso, não será feita exceção, o que não é uma prática recomendada. No entanto, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja lançado.
Aplica-se a
AddValue(String, Char)
Adiciona um valor de carácter Unicode à SerializationInfo loja.
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 associar ao valor, para que possa ser desserializado mais tarde.
- value
- Char
O valor da personagem a serializar.
Exceções
O name parâmetro é null.
Um valor já foi associado a name.
Observações
Se dois valores forem somados com nomes que diferem apenas por caso, não será feita exceção, o que não é uma prática recomendada. No entanto, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja lançado.
Aplica-se a
AddValue(String, Byte)
Adiciona um valor inteiro não assinado de 8 bits à SerializationInfo loja.
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 associar ao valor, para que possa ser desserializado mais tarde.
- value
- Byte
O valor do byte a serializar.
Exceções
O name parâmetro é null.
Um valor já foi associado a name.
Observações
Se dois valores forem somados com nomes que diferem apenas por caso, não será feita exceção, o que não é uma prática recomendada. No entanto, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja lançado.
Aplica-se a
AddValue(String, Boolean)
Adiciona um valor booleano à SerializationInfo loja.
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 associar ao valor, para que possa ser desserializado mais tarde.
- value
- Boolean
O valor booleano a serializar.
Exceções
O name parâmetro é null.
Um valor já foi associado a name.
Observações
Se dois valores forem somados com nomes que diferem apenas por caso, não será feita exceção, o que não é uma prática recomendada. No entanto, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja lançado. 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