SerializationInfo.AddValue Metódus

Definíció

Névtér:

System.Runtime.Serialization

Szerelvények:

netstandard.dll, System.Runtime.dll

Értéket ad hozzá a SerializationInfo.

Túlterhelések

Name	Description
AddValue(String, Object, Type)	Értéket ad hozzá az SerializationInfo áruházhoz, amelyhez value társítva name van, és szerializálva van Typetype.
AddValue(String, UInt64)	64 bites, aláíratlan egész számértéket ad hozzá az SerializationInfo áruházhoz.
AddValue(String, UInt32)	32 bites, aláíratlan egész számértéket ad hozzá az SerializationInfo áruházhoz.
AddValue(String, UInt16)	16 bites, aláíratlan egész számértéket ad hozzá az SerializationInfo áruházhoz.
AddValue(String, Single)	Egy pontosságú lebegőpontos értéket ad hozzá az SerializationInfo áruházhoz.
AddValue(String, SByte)	8 bites aláírt egész számot ad hozzá az SerializationInfo áruházhoz.
AddValue(String, Object)	Hozzáadja a megadott objektumot az SerializationInfo áruházhoz, ahol egy megadott névhez van társítva.
AddValue(String, Int64)	64 bites aláírt egész számot ad hozzá az SerializationInfo áruházhoz.
AddValue(String, Int32)	32 bites aláírt egész számot ad hozzá az SerializationInfo áruházhoz.
AddValue(String, Int16)	16 bites aláírt egész számot ad hozzá az SerializationInfo áruházhoz.
AddValue(String, Double)	Dupla pontosságú lebegőpontos értéket ad hozzá az SerializationInfo áruházhoz.
AddValue(String, Decimal)	Decimális értéket ad hozzá az SerializationInfo áruházhoz.
AddValue(String, DateTime)	Értéket ad DateTime hozzá az SerializationInfo áruházhoz.
AddValue(String, Char)	Unicode karakterértéket ad hozzá az SerializationInfo áruházhoz.
AddValue(String, Byte)	8 bites, aláíratlan egész számértéket ad hozzá az SerializationInfo áruházhoz.
AddValue(String, Boolean)	Logikai értéket ad hozzá az SerializationInfo áruházhoz.

AddValue(String, Object, Type)

Forrás:

SerializationInfo.cs

Értéket ad hozzá az SerializationInfo áruházhoz, amelyhez value társítva name van, és szerializálva van 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)

Paraméterek

name

String

Az értékhez társítandó név, amely később deszerializálható.

value

Object

A szerializálandó érték. Az objektum minden gyermeke automatikusan szerializálva lesz.

type

Type

Az Type aktuális objektumhoz társítandó. Ennek a paraméternek mindig magának az objektumnak vagy az egyik alaposztályának típusának kell lennie.

Kivételek

ArgumentNullException

Ha name vagy type igen null.

SerializationException

Egy érték már van társítva.name

Megjegyzések

A hozzárendelt típus mindig az objektum vagy annak egyik szülője.

Ha két olyan értéket ad hozzá, amelyek neve csak esetenként különbözik, a rendszer nem ad kivételt, ami nem ajánlott eljárás. Ha azonban két azonos nevű értéket ad hozzá, az SerializationException a dobást okozza.

AddValue(String, UInt64)

Forrás:

SerializationInfo.cs

Fontos

Ez az API nem CLS-kompatibilis.

64 bites, aláíratlan egész számértéket ad hozzá az SerializationInfo áruházhoz.

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)

Paraméterek

name

String

Az értékhez társítandó név, amely később deszerializálható.

value

UInt64

A szerializálandó érték.

Attribútumok

CLSCompliantAttribute

Kivételek

ArgumentNullException

A name paraméter a következő null: .

SerializationException

Egy érték már van társítva.name

Megjegyzések

Ha két olyan értéket ad hozzá, amelyek neve csak esetenként különbözik, a rendszer nem ad kivételt, ami nem ajánlott eljárás. Ha azonban két azonos nevű értéket ad hozzá, az SerializationException a dobást okozza.

AddValue(String, UInt32)

Forrás:

SerializationInfo.cs

Fontos

Ez az API nem CLS-kompatibilis.

32 bites, aláíratlan egész számértéket ad hozzá az SerializationInfo áruházhoz.

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)

Paraméterek

name

String

Az értékhez társítandó név, amely később deszerializálható.

value

UInt32

A UInt32 szerializálandó érték.

Attribútumok

CLSCompliantAttribute

Kivételek

ArgumentNullException

A name paraméter a következő null: .

SerializationException

Egy érték már van társítva.name

Megjegyzések

Ha két olyan értéket ad hozzá, amelyek neve csak esetenként különbözik, a rendszer nem ad kivételt, ami nem ajánlott eljárás. Ha azonban két azonos nevű értéket ad hozzá, az SerializationException a dobást okozza.

AddValue(String, UInt16)

Forrás:

SerializationInfo.cs

Fontos

Ez az API nem CLS-kompatibilis.

16 bites, aláíratlan egész számértéket ad hozzá az SerializationInfo áruházhoz.

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)

Paraméterek

name

String

Az értékhez társítandó név, amely később deszerializálható.

value

UInt16

A UInt16 szerializálandó érték.

Attribútumok

CLSCompliantAttribute

Kivételek

ArgumentNullException

A name paraméter a következő null: .

SerializationException

Egy érték már van társítva.name

Megjegyzések

Ha két olyan értéket ad hozzá, amelyek neve csak esetenként különbözik, a rendszer nem ad kivételt, ami nem ajánlott eljárás. Ha azonban két azonos nevű értéket ad hozzá, az SerializationException a dobást okozza.

AddValue(String, Single)

Forrás:

SerializationInfo.cs

Egy pontosságú lebegőpontos értéket ad hozzá az SerializationInfo áruházhoz.

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)

Paraméterek

name

String

Az értékhez társítandó név, amely később deszerializálható.

value

Single

A szerializálandó egyetlen érték.

Kivételek

ArgumentNullException

A name paraméter a következő null: .

SerializationException

Egy érték már van társítva.name

Megjegyzések

Ha két olyan értéket ad hozzá, amelyek neve csak esetenként különbözik, a rendszer nem ad kivételt, ami nem ajánlott eljárás. Ha azonban két azonos nevű értéket ad hozzá, az SerializationException a dobást okozza.

AddValue(String, SByte)

Forrás:

SerializationInfo.cs

Fontos

Ez az API nem CLS-kompatibilis.

8 bites aláírt egész számot ad hozzá az SerializationInfo áruházhoz.

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)

Paraméterek

name

String

Az értékhez társítandó név, amely később deszerializálható.

value

SByte

A Sbyte szerializálandó érték.

Attribútumok

CLSCompliantAttribute

Kivételek

ArgumentNullException

A name paraméter a következő null: .

SerializationException

Egy érték már van társítva.name

Megjegyzések

Ha két olyan értéket ad hozzá, amelyek neve csak esetenként különbözik, a rendszer nem ad kivételt, ami nem ajánlott eljárás. Ha azonban két azonos nevű értéket ad hozzá, az SerializationException a dobást okozza.

AddValue(String, Object)

Forrás:

SerializationInfo.cs

Hozzáadja a megadott objektumot az SerializationInfo áruházhoz, ahol egy megadott névhez van társítva.

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)

Paraméterek

name

String

Az értékhez társítandó név, amely később deszerializálható.

value

Object

A szerializálandó érték. Az objektum minden gyermeke automatikusan szerializálva lesz.

Kivételek

ArgumentNullException

name az null.

SerializationException

Egy érték már van társítva.name

Megjegyzések

A paraméterben value található objektum szerializálva lesz a visszaadott valuetípusként.

Ha két olyan értéket ad hozzá, amelyek neve csak esetenként különbözik, a rendszer nem ad kivételt, ami nem ajánlott eljárás. Ha azonban két azonos nevű értéket ad hozzá, az SerializationException a dobást okozza.

AddValue(String, Int64)

Forrás:

SerializationInfo.cs

64 bites aláírt egész számot ad hozzá az SerializationInfo áruházhoz.

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)

Paraméterek

name

String

Az értékhez társítandó név, amely később deszerializálható.

value

Int64

A szerializálni kívánt Int64-érték.

Kivételek

ArgumentNullException

A name paraméter a következő null: .

SerializationException

Egy érték már van társítva.name

Megjegyzések

Ha két olyan értéket ad hozzá, amelyek neve csak esetenként különbözik, a rendszer nem ad kivételt, ami nem ajánlott eljárás. Ha azonban két azonos nevű értéket ad hozzá, az SerializationException a dobást okozza.

AddValue(String, Int32)

Forrás:

SerializationInfo.cs

32 bites aláírt egész számot ad hozzá az SerializationInfo áruházhoz.

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)

Paraméterek

name

String

Az értékhez társítandó név, amely később deszerializálható.

value

Int32

A Int32 szerializálandó érték.

Kivételek

ArgumentNullException

A name paraméter a következő null: .

SerializationException

Egy érték már van társítva.name

Megjegyzések

Ha két olyan értéket ad hozzá, amelyek neve csak esetenként különbözik, a rendszer nem ad kivételt, ami nem ajánlott eljárás. Ha azonban két azonos nevű értéket ad hozzá, az SerializationException a dobást okozza.

AddValue(String, Int16)

Forrás:

SerializationInfo.cs

16 bites aláírt egész számot ad hozzá az SerializationInfo áruházhoz.

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)

Paraméterek

name

String

Az értékhez társítandó név, amely később deszerializálható.

value

Int16

A Int16 szerializálandó érték.

Kivételek

ArgumentNullException

A name paraméter a következő null: .

SerializationException

Egy érték már van társítva.name

Megjegyzések

Ha két olyan értéket ad hozzá, amelyek neve csak esetenként különbözik, a rendszer nem ad kivételt, ami nem ajánlott eljárás. Ha azonban két azonos nevű értéket ad hozzá, az SerializationException a dobást okozza.

AddValue(String, Double)

Forrás:

SerializationInfo.cs

Dupla pontosságú lebegőpontos értéket ad hozzá az SerializationInfo áruházhoz.

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)

Paraméterek

name

String

Az értékhez társítandó név, amely később deszerializálható.

value

Double

A szerializálandó dupla érték.

Kivételek

ArgumentNullException

A name paraméter a következő null: .

SerializationException

Egy érték már van társítva.name

Megjegyzések

Ha két olyan értéket ad hozzá, amelyek neve csak esetenként különbözik, a rendszer nem ad kivételt, ami nem ajánlott eljárás. Ha azonban két azonos nevű értéket ad hozzá, az SerializationException a dobást okozza.

AddValue(String, Decimal)

Forrás:

SerializationInfo.cs

Decimális értéket ad hozzá az SerializationInfo áruházhoz.

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)

Paraméterek

name

String

Az értékhez társítandó név, amely később deszerializálható.

value

Decimal

A szerializálandó decimális érték.

Kivételek

ArgumentNullException

Ha a name paraméter .null

SerializationException

Ha egy érték már van társítva .name

Megjegyzések

Ha két olyan értéket ad hozzá, amelyek neve csak esetenként különbözik, a rendszer nem ad kivételt, ami nem ajánlott eljárás. Ha azonban két azonos nevű értéket ad hozzá, az SerializationException a dobást okozza.

AddValue(String, DateTime)

Forrás:

SerializationInfo.cs

Értéket ad DateTime hozzá az SerializationInfo áruházhoz.

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)

Paraméterek

name

String

Az értékhez társítandó név, amely később deszerializálható.

value

DateTime

A DateTime szerializálandó érték.

Kivételek

ArgumentNullException

A name paraméter a következő null: .

SerializationException

Egy érték már van társítva.name

Megjegyzések

Ha két olyan értéket ad hozzá, amelyek neve csak esetenként különbözik, a rendszer nem ad kivételt, ami nem ajánlott eljárás. Ha azonban két azonos nevű értéket ad hozzá, az SerializationException a dobást okozza.

AddValue(String, Char)

Forrás:

SerializationInfo.cs

Unicode karakterértéket ad hozzá az SerializationInfo áruházhoz.

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)

Paraméterek

name

String

Az értékhez társítandó név, amely később deszerializálható.

value

Char

A szerializálandó karakterérték.

Kivételek

ArgumentNullException

A name paraméter a következő null: .

SerializationException

Egy érték már van társítva.name

Megjegyzések

Ha két olyan értéket ad hozzá, amelyek neve csak esetenként különbözik, a rendszer nem ad kivételt, ami nem ajánlott eljárás. Ha azonban két azonos nevű értéket ad hozzá, az SerializationException a dobást okozza.

AddValue(String, Byte)

Forrás:

SerializationInfo.cs

8 bites, aláíratlan egész számértéket ad hozzá az SerializationInfo áruházhoz.

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)

Paraméterek

name

String

Az értékhez társítandó név, amely később deszerializálható.

value

Byte

A szerializálandó bájtérték.

Kivételek

ArgumentNullException

A name paraméter a következő null: .

SerializationException

Egy érték már van társítva.name

Megjegyzések

Ha két olyan értéket ad hozzá, amelyek neve csak esetenként különbözik, a rendszer nem ad kivételt, ami nem ajánlott eljárás. Ha azonban két azonos nevű értéket ad hozzá, az SerializationException a dobást okozza.

AddValue(String, Boolean)

Forrás:

SerializationInfo.cs

Logikai értéket ad hozzá az SerializationInfo áruházhoz.

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)

Paraméterek

name

String

Az értékhez társítandó név, amely később deszerializálható.

value

Boolean

A szerializálandó logikai érték.

Kivételek

ArgumentNullException

A name paraméter a következő null: .

SerializationException

Egy érték már van társítva.name

Megjegyzések

Ha két olyan értéket ad hozzá, amelyek neve csak esetenként különbözik, a rendszer nem ad kivételt, ami nem ajánlott eljárás. Ha azonban két azonos nevű értéket ad hozzá, az SerializationException a dobást okozza. Például:

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