SerializationInfo.AddValue Metoda

Definice

Obor názvů:

System.Runtime.Serialization

Sestavení:

System.Runtime.dll

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

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

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.

AddValue(String, UInt64)

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

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.

AddValue(String, UInt32)

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

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.

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

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.

AddValue(String, Single)

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

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.

AddValue(String, SByte)

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

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.

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ě, 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.

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.

AddValue(String, Int64)

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

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.

AddValue(String, Int32)

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

AddValue(String, Int16)

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

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

AddValue(String, Double)

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

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

AddValue(String, Decimal)

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

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

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ě, 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

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

AddValue(String, Char)

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

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

AddValue(String, Byte)

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

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

AddValue(String, Boolean)

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

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