SerializationInfo.AddValue Metoda

Definice

Obor názvů:

System.Runtime.Serialization

Sestavení:

netstandard.dll, System.Runtime.dll

Přidá hodnotu do SerializationInfo.

Přetížení

Name	Description
AddValue(String, Object, Type)	Přidá hodnotu do SerializationInfo úložiště, kde value je přidružena name a je serializována jako .Typetype
AddValue(String, UInt64)	Přidá do SerializationInfo úložiště 64bitovou celočíselnou hodnotu bez znaménka.
AddValue(String, UInt32)	Přidá do SerializationInfo úložiště 32bitovou celočíselnou hodnotu bez znaménka.
AddValue(String, UInt16)	Přidá do úložiště 16bitovou celočíselnou hodnotu SerializationInfo bez znaménka.
AddValue(String, Single)	Přidá hodnotu s plovoucí desetinnou čárkou s jednoduchou přesností do SerializationInfo úložiště.
AddValue(String, SByte)	Přidá 8bitovou celočíselnou hodnotu do SerializationInfo úložiště.
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á 64bitovou celočíselnou hodnotu do SerializationInfo úložiště.
AddValue(String, Int32)	Přidá 32bitovou celočíselnou hodnotu do SerializationInfo úložiště.
AddValue(String, Int16)	Přidá 16bitovou celočíselnou hodnotu do SerializationInfo úložiště.
AddValue(String, Double)	Přidá hodnotu s plovoucí desetinnou čárkou s dvojitou přesností do SerializationInfo úložiště.
AddValue(String, Decimal)	Přidá desetinnou hodnotu do SerializationInfo úložiště.
AddValue(String, DateTime)	DateTime Přidá hodnotu do SerializationInfo úložiště.
AddValue(String, Char)	Přidá do úložiště hodnotu znaku SerializationInfo Unicode.
AddValue(String, Byte)	Přidá do SerializationInfo úložiště 8bitovou celočíselnou hodnotu bez znaménka.
AddValue(String, Boolean)	Přidá logickou hodnotu do SerializationInfo úložiště.

AddValue(String, Object, Type)

Zdroj:

SerializationInfo.cs

Přidá hodnotu do SerializationInfo úložiště, kde value je přidružena name a je serializována jako .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 -> 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ě, takže může být deserializován později.

value

Object

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

type

Type

Přidružení Type k aktuálnímu objektu. Tento parametr musí být vždy typem samotného objektu nebo jedné ze svých základních tříd.

Výjimky

ArgumentNullException

Je-li name nebo type je null.

SerializationException

Hodnota již byla přidružena 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 v případě, nebude vyvolán žá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í.

AddValue(String, UInt64)

Zdroj:

SerializationInfo.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Přidá do SerializationInfo úložiště 64bitovou celočíselnou hodnotu bez znaménka.

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ě, takže může být deserializován později.

value

UInt64

Hodnota k serializaci.

Atributy

CLSCompliantAttribute

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota již byla přidružena name.

Poznámky

Pokud se přidají dvě hodnoty s názvy, které se liší pouze v případě, nebude vyvolán žá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í.

AddValue(String, UInt32)

Zdroj:

SerializationInfo.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Přidá do SerializationInfo úložiště 32bitovou celočíselnou hodnotu bez znaménka.

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ě, takže může být deserializován později.

value

UInt32

Hodnota UInt32 k serializaci.

Atributy

CLSCompliantAttribute

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota již byla přidružena name.

Poznámky

Pokud se přidají dvě hodnoty s názvy, které se liší pouze v případě, nebude vyvolán žá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í.

AddValue(String, UInt16)

Zdroj:

SerializationInfo.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Přidá do úložiště 16bitovou celočíselnou hodnotu SerializationInfo bez znaménka.

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ě, takže může být deserializován později.

value

UInt16

Hodnota UInt16 k serializaci.

Atributy

CLSCompliantAttribute

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota již byla přidružena name.

Poznámky

Pokud se přidají dvě hodnoty s názvy, které se liší pouze v případě, nebude vyvolán žá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í.

AddValue(String, Single)

Zdroj:

SerializationInfo.cs

Přidá hodnotu s plovoucí desetinnou čárkou s jednoduchou přesností do SerializationInfo úložiště.

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ě, takže může být deserializován později.

value

Single

Jedna hodnota, která se má serializovat.

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota již byla přidružena name.

Poznámky

Pokud se přidají dvě hodnoty s názvy, které se liší pouze v případě, nebude vyvolán žá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í.

AddValue(String, SByte)

Zdroj:

SerializationInfo.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

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

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ě, takže může být deserializován později.

value

SByte

Hodnota Sbyte k serializaci.

Atributy

CLSCompliantAttribute

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota již byla přidružena name.

Poznámky

Pokud se přidají dvě hodnoty s názvy, které se liší pouze v případě, nebude vyvolán žá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í.

AddValue(String, Object)

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);

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ě, takže může být deserializován později.

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 name.

Poznámky

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

Pokud se přidají dvě hodnoty s názvy, které se liší pouze v případě, nebude vyvolán žá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í.

AddValue(String, Int64)

Zdroj:

SerializationInfo.cs

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

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ě, takže může být deserializován později.

value

Int64

Hodnota Int64 k serializaci.

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota již byla přidružena name.

Poznámky

Pokud se přidají dvě hodnoty s názvy, které se liší pouze v případě, nebude vyvolán žá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í.

AddValue(String, Int32)

Zdroj:

SerializationInfo.cs

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

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ě, takže může být deserializován později.

value

Int32

Hodnota Int32 k serializaci.

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota již byla přidružena name.

Poznámky

Pokud se přidají dvě hodnoty s názvy, které se liší pouze v případě, nebude vyvolán žá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í.

AddValue(String, Int16)

Zdroj:

SerializationInfo.cs

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

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ě, takže může být deserializován později.

value

Int16

Hodnota Int16 k serializaci.

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota již byla přidružena name.

Poznámky

Pokud se přidají dvě hodnoty s názvy, které se liší pouze v případě, nebude vyvolán žá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í.

AddValue(String, Double)

Zdroj:

SerializationInfo.cs

Přidá hodnotu s plovoucí desetinnou čárkou s dvojitou přesností do SerializationInfo úložiště.

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ě, takže může být deserializován později.

value

Double

Dvojitá hodnota serializace.

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota již byla přidružena name.

Poznámky

Pokud se přidají dvě hodnoty s názvy, které se liší pouze v případě, nebude vyvolán žá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í.

AddValue(String, Decimal)

Zdroj:

SerializationInfo.cs

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

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ě, takže může být deserializován později.

value

Decimal

Desetinná hodnota, která se má serializovat.

Výjimky

ArgumentNullException

name Pokud je nullparametr .

SerializationException

Pokud již byla hodnota přidružena name.

Poznámky

Pokud se přidají dvě hodnoty s názvy, které se liší pouze v případě, nebude vyvolán žá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í.

AddValue(String, DateTime)

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ě, takže může být deserializován později.

value

DateTime

Hodnota DateTime k serializaci.

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota již byla přidružena name.

Poznámky

Pokud se přidají dvě hodnoty s názvy, které se liší pouze v případě, nebude vyvolán žá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í.

AddValue(String, Char)

Zdroj:

SerializationInfo.cs

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

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ě, takže může být deserializován později.

value

Char

Hodnota znaku, která se má serializovat.

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota již byla přidružena name.

Poznámky

Pokud se přidají dvě hodnoty s názvy, které se liší pouze v případě, nebude vyvolán žá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í.

AddValue(String, Byte)

Zdroj:

SerializationInfo.cs

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

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ě, takže může být deserializován později.

value

Byte

Bajtová hodnota, která se má serializovat.

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota již byla přidružena name.

Poznámky

Pokud se přidají dvě hodnoty s názvy, které se liší pouze v případě, nebude vyvolán žá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í.

AddValue(String, Boolean)

Zdroj:

SerializationInfo.cs

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

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ě, takže může být deserializován později.

value

Boolean

Logická hodnota k serializaci.

Výjimky

ArgumentNullException

Parametr name je null.

SerializationException

Hodnota již byla přidružena name.

Poznámky

Pokud se přidají dvě hodnoty s názvy, které se liší pouze v případě, nebude vyvolán žá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í. Příklad:

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