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
| AddValue(String, Object, Type) |
Adiciona um valor ao repositório SerializationInfo, em que |
| 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 simples 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 repositório SerializationInfo, no qual ele é 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 valor DateTime 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)
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
Adiciona um valor ao repositório SerializationInfo, em que value é associado ao name e é serializado como sendo do 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
O nome a ser associado ao valor, de modo que ele possa ser desserializado mais tarde.
- value
- Object
O valor a ser serializado. Nenhum filho desse objeto será serializado automaticamente.
- type
- Type
O Type a ser associado ao objeto atual. Esse parâmetro sempre deve ser do tipo do próprio objeto ou uma de suas classes base.
Exceções
Se name ou type for null.
Um valor já foi associado a name.
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, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja gerado.
Aplica-se a
AddValue(String, UInt64)
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
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, de modo que ele possa ser desserializado mais tarde.
- value
- UInt64
O valor a ser serializado.
- Atributos
Exceções
O parâmetro name é null.
Um valor já foi associado a name.
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, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja gerado.
Aplica-se a
AddValue(String, UInt32)
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
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, de modo que ele possa ser desserializado mais tarde.
- Atributos
Exceções
O parâmetro name é null.
Um valor já foi associado a name.
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, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja gerado.
Aplica-se a
AddValue(String, UInt16)
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
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, de modo que ele possa ser desserializado mais tarde.
- Atributos
Exceções
O parâmetro name é null.
Um valor já foi associado a name.
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, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja gerado.
Aplica-se a
AddValue(String, Single)
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
Adiciona um valor de ponto flutuante de precisão simples 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, de modo que ele possa ser desserializado mais tarde.
- value
- Single
O único valor a ser serializado.
Exceções
O parâmetro name é null.
Um valor já foi associado a name.
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, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja gerado.
Aplica-se a
AddValue(String, SByte)
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
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, de modo que ele possa ser desserializado mais tarde.
- value
- SByte
O valor Sbyte a ser serializado.
- Atributos
Exceções
O parâmetro name é null.
Um valor já foi associado a name.
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, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja gerado.
Aplica-se a
AddValue(String, Object)
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
Adiciona o objeto especificado ao repositório SerializationInfo, no qual ele é associado a um nome 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
O nome a ser associado ao valor, de modo que ele possa ser desserializado mais tarde.
- value
- Object
O valor a ser serializado. Nenhum filho desse objeto será serializado automaticamente.
Exceções
name é null.
Um valor já foi associado a name.
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, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja gerado.
Aplica-se a
AddValue(String, Int64)
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
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, de modo que ele possa ser desserializado mais tarde.
- value
- Int64
O valor Int64 a ser serializado.
Exceções
O parâmetro name é null.
Um valor já foi associado a name.
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, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja gerado.
Aplica-se a
AddValue(String, Int32)
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
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, de modo que ele possa ser desserializado mais tarde.
Exceções
O parâmetro name é null.
Um valor já foi associado a name.
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, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja gerado.
Aplica-se a
AddValue(String, Int16)
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
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, de modo que ele possa ser desserializado mais tarde.
Exceções
O parâmetro name é null.
Um valor já foi associado a name.
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, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja gerado.
Aplica-se a
AddValue(String, Double)
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
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, de modo que ele possa ser desserializado mais tarde.
- value
- Double
O valor duplo a ser serializado.
Exceções
O parâmetro name é null.
Um valor já foi associado a name.
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, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja gerado.
Aplica-se a
AddValue(String, Decimal)
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
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, de modo que ele possa ser desserializado mais tarde.
- value
- Decimal
O valor decimal a ser serializado.
Exceções
Se o parâmetro name for null.
Se um valor já tiver sido associado ao name.
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, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja gerado.
Aplica-se a
AddValue(String, DateTime)
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
Adiciona um valor DateTime 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, de modo que ele possa ser desserializado mais tarde.
Exceções
O parâmetro name é null.
Um valor já foi associado a name.
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, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja gerado.
Aplica-se a
AddValue(String, Char)
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
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, de modo que ele possa ser desserializado mais tarde.
- value
- Char
O valor de caractere a ser serializado.
Exceções
O parâmetro name é null.
Um valor já foi associado a name.
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, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja gerado.
Aplica-se a
AddValue(String, Byte)
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
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, de modo que ele possa ser desserializado mais tarde.
- value
- Byte
O valor de byte a ser serializado.
Exceções
O parâmetro name é null.
Um valor já foi associado a name.
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, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja gerado.
Aplica-se a
AddValue(String, Boolean)
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
- Origem:
- SerializationInfo.cs
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, de modo que ele possa ser desserializado mais tarde.
- value
- Boolean
O valor booliano a ser serializado.
Exceções
O parâmetro name é null.
Um valor já foi associado a name.
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, adicionar dois valores com exatamente o mesmo nome fará com que o SerializationException seja gerado. 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
