SerializationInfo.AddValue Metoda

Reference

Definice

Obor názvů:: System.Runtime.Serialization

Sestavení:: System.Runtime.dll

Sestavení:: System.Runtime.Serialization.Formatters.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Přidá hodnotu do .SerializationInfo

Přetížení

AddValue(String, Object, Type)	Přidá hodnotu do SerializationInfo úložiště, kde `value` je přidružena `name` k a je serializována jako hodnota Type`type`.
AddValue(String, UInt64)	Přidá do úložiště 64bitovou celočíselnou hodnotu bez znaménka SerializationInfo .
AddValue(String, UInt32)	Přidá do úložiště 32bitovou celočíselnou hodnotu bez znaménka SerializationInfo .
AddValue(String, UInt16)	Přidá do úložiště 16bitovou celočíselnou hodnotu bez znaménka SerializationInfo .
AddValue(String, Single)	Přidá do úložiště hodnotu s plovoucí desetinou čárkou s jednou přesností SerializationInfo .
AddValue(String, SByte)	Přidá do SerializationInfo úložiště 8bitovou celočíselnou hodnotu.
AddValue(String, Object)	Přidá zadaný objekt do SerializationInfo úložiště, kde je přidružen k zadanému názvu.
AddValue(String, Int64)	Přidá do úložiště 64bitovou celočíselnou hodnotu se signoum sadou SerializationInfo .
AddValue(String, Int32)	Přidá do úložiště 32bitovou celočíselnou hodnotu se signoumi SerializationInfo hodnotou.
AddValue(String, Int16)	Přidá do úložiště 16bitovou celočíselnou hodnotu se signoumi hodnotou SerializationInfo .
AddValue(String, Double)	Přidá do úložiště hodnotu s plovoucí desetinou čárkou s dvojitou přesností SerializationInfo .
AddValue(String, Decimal)	Přidá do SerializationInfo úložiště desetinnou hodnotu.
AddValue(String, DateTime)	DateTime Přidá hodnotu do SerializationInfo úložiště.
AddValue(String, Char)	Přidá do SerializationInfo úložiště znakovou hodnotu Unicode.
AddValue(String, Byte)	Přidá do úložiště 8bitovou celočíselnou hodnotu bez znaménka SerializationInfo .
AddValue(String, Boolean)	Přidá do SerializationInfo úložiště logickou hodnotu.

AddValue(String, Object, Type)

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Přidá hodnotu do SerializationInfo úložiště, kde value je přidružena name k a je serializována jako hodnota 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)

Parametry

name: String

Název, který se má přidružit k hodnotě, aby mohl být později deserializován.

value: Object

Hodnota, která má být serializována. Všechny podřízené položky tohoto objektu budou automaticky serializovány.

type: Type

Objekt Type , který se má přidružit k aktuálnímu objektu. Tento parametr musí být vždy typem samotného objektu nebo jedné z jeho základních tříd.

Výjimky

ArgumentNullException

Pokud name nebo type je null.

SerializationException

Hodnota již byla přidružena k name.

Poznámky

Přiřazený typ je vždy typem objektu nebo jedním z jeho nadřazených objektů.

Pokud se přidají dvě hodnoty s názvy, které se liší pouze písmeny a písmeny, nevyvolá se žádná výjimka, což není doporučený postup. Přidání dvou hodnot se stejným názvem však způsobí SerializationException vyvolání hodnoty.

Platí pro

AddValue(String, UInt64)

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Přidá do úložiště 64bitovou celočíselnou hodnotu bez znaménka 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)

Parametry

name: String

Název, který se má přidružit k hodnotě, aby mohl být později deserializován.

value: UInt64

Hodnota, která se má serializovat.

Atributy: CLSCompliantAttribute

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota již byla přidružena k name.

Poznámky

Platí pro

AddValue(String, UInt32)

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Přidá do úložiště 32bitovou celočíselnou hodnotu bez znaménka 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)

Parametry

name: String

Název, který se má přidružit k hodnotě, aby mohl být později deserializován.

value: UInt32

Hodnota UInt32 , která se má serializovat.

Atributy: CLSCompliantAttribute

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota již byla přidružena k name.

Poznámky

Platí pro

AddValue(String, UInt16)

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Přidá do úložiště 16bitovou celočíselnou hodnotu bez znaménka 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)

Parametry

name: String

Název, který se má přidružit k hodnotě, aby mohl být později deserializován.

value: UInt16

Hodnota UInt16 , která se má serializovat.

Atributy: CLSCompliantAttribute

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota již byla přidružena k name.

Poznámky

Platí pro

AddValue(String, Single)

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Přidá do úložiště hodnotu s plovoucí desetinou čárkou s jednou přesností 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)

Parametry

name: String

Název, který se má přidružit k hodnotě, aby mohl být později deserializován.

value: Single

Jedna hodnota, která se má serializovat.

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota již byla přidružena k name.

Poznámky

Platí pro

AddValue(String, SByte)

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Přidá do SerializationInfo úložiště 8bitovou celočíselnou hodnotu.

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)

Parametry

name: String

Název, který se má přidružit k hodnotě, aby mohl být později deserializován.

value: SByte

Hodnota Sbyte , která se má serializovat.

Atributy: CLSCompliantAttribute

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota již byla přidružena k name.

Poznámky

Platí pro

AddValue(String, Object)

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Přidá zadaný objekt do SerializationInfo úložiště, kde je přidružen k zadanému názvu.

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)

Parametry

name: String

Název, který se má přidružit k hodnotě, aby mohl být později deserializován.

value: Object

Hodnota, která má být serializována. Všechny podřízené položky tohoto objektu budou automaticky serializovány.

Výjimky

ArgumentNullException

name je null.

SerializationException

Hodnota již byla přidružena k name.

Poznámky

Objekt obsažený v parametru value je serializován jako typ vrácený parametrem value.

Platí pro

AddValue(String, Int64)

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Přidá do úložiště 64bitovou celočíselnou hodnotu se signoum parametrem 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)

Parametry

name: String

Název, který se má přidružit k hodnotě, aby mohl být později deserializován.

value: Int64

Hodnota Int64, která se má serializovat.

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota již byla přidružena k name.

Poznámky

Platí pro

AddValue(String, Int32)

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Přidá do úložiště 32bitovou celočíselnou hodnotu se signoum SerializationInfo sadou.

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)

Parametry

name: String

Název, který se má přidružit k hodnotě, aby ji bylo možné později deserializovat.

value: Int32

Hodnota Int32 serializace.

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota už je přidružená k name.

Poznámky

Pokud se přidají dvě hodnoty s názvy, které se liší pouze velikostí písmen, nevyvolá se žádná výjimka, což není doporučený postup. Přidání dvou hodnot se stejným názvem však způsobí SerializationException vyvolání.

Platí pro

AddValue(String, Int16)

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Přidá do úložiště 16bitovou celočíselnou hodnotu se signedýmm číslem 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)

Parametry

name: String

Název, který se má přidružit k hodnotě, aby ji bylo možné později deserializovat.

value: Int16

Hodnota Int16 serializace.

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota už je přidružená k name.

Poznámky

Platí pro

AddValue(String, Double)

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Přidá do úložiště hodnotu s plovoucí desetinou čárkou s dvojitou přesností 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)

Parametry

name: String

Název, který se má přidružit k hodnotě, aby ji bylo možné později deserializovat.

value: Double

Dvojitá hodnota serializace.

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota už je přidružená k name.

Poznámky

Platí pro

AddValue(String, Decimal)

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Přidá do SerializationInfo úložiště desetinnou hodnotu.

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)

Parametry

name: String

Název, který se má přidružit k hodnotě, aby ji bylo možné později deserializovat.

value: Decimal

Desetinná hodnota, která se má serializovat.

Výjimky

ArgumentNullException

Pokud parametr je namenull.

SerializationException

Pokud už je hodnota přidružená k name.

Poznámky

Platí pro

AddValue(String, DateTime)

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

DateTime Přidá hodnotu do SerializationInfo úložiště.

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)

Parametry

name: String

Název, který se má přidružit k hodnotě, aby ji bylo možné později deserializovat.

value: DateTime

Hodnota DateTime serializace.

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota už je přidružená k name.

Poznámky

Platí pro

AddValue(String, Char)

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Přidá znakovou hodnotu Unicode do SerializationInfo úložiště.

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)

Parametry

name: String

Název, který se má přidružit k hodnotě, aby ji bylo možné později deserializovat.

value: Char

Hodnota znaku, která se má serializovat.

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota už je přidružená k name.

Poznámky

Platí pro

AddValue(String, Byte)

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Přidá do úložiště 8bitovou celočíselnou hodnotu bez znaménka 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)

Parametry

name: String

Název, který se má přidružit k hodnotě, aby ji bylo možné později deserializovat.

value: Byte

Hodnota bajtu, která se má serializovat.

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota už je přidružená k name.

Poznámky

Platí pro

AddValue(String, Boolean)

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Zdroj:: SerializationInfo.cs

Přidá do SerializationInfo úložiště logickou hodnotu.

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)

Parametry

name: String

Název, který se má přidružit k hodnotě, aby ji bylo možné později deserializovat.

value: Boolean

Logická hodnota serializace.

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota už je přidružená k name.

Poznámky

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

Platí pro