SerializationInfo.AddValue Metoda

Definicja

Przestrzeń nazw:

System.Runtime.Serialization

Zestaw:

System.Runtime.dll

Dodaje wartość do elementu SerializationInfo.

Przeciążenia

AddValue(String, Object, Type)	Dodaje wartość do SerializationInfo magazynu, z którym value jest skojarzona i name jest serializowana jako wartość Typetype.
AddValue(String, UInt64)	Dodaje 64-bitową niepodpisaną wartość całkowitą do SerializationInfo magazynu.
AddValue(String, UInt32)	Dodaje 32-bitową niepodpisaną wartość całkowitą do SerializationInfo magazynu.
AddValue(String, UInt16)	Dodaje 16-bitową niepodpisaną wartość całkowitą do SerializationInfo magazynu.
AddValue(String, Single)	Dodaje wartość zmiennoprzecinkową o pojedynczej precyzji SerializationInfo do magazynu.
AddValue(String, SByte)	Dodaje 8-bitową wartość całkowitą ze znakiem SerializationInfo do magazynu.
AddValue(String, Object)	Dodaje określony obiekt do SerializationInfo magazynu, gdzie jest skojarzony z określoną nazwą.
AddValue(String, Int64)	Dodaje 64-bitową wartość całkowitą ze znakiem SerializationInfo do magazynu.
AddValue(String, Int32)	Dodaje 32-bitową wartość całkowitą ze znakiem SerializationInfo do magazynu.
AddValue(String, Int16)	Dodaje 16-bitową wartość całkowitą ze znakiem SerializationInfo do magazynu.
AddValue(String, Double)	Dodaje do magazynu wartość zmiennoprzecinkową o podwójnej precyzji SerializationInfo .
AddValue(String, Decimal)	Dodaje wartość dziesiętną do SerializationInfo magazynu.
AddValue(String, DateTime)	DateTime Dodaje wartość do SerializationInfo magazynu.
AddValue(String, Char)	Dodaje wartość znaku Unicode do SerializationInfo magazynu.
AddValue(String, Byte)	Dodaje 8-bitową wartość całkowitą bez znaku do SerializationInfo magazynu.
AddValue(String, Boolean)	Dodaje wartość logiczną do SerializationInfo magazynu.

AddValue(String, Object, Type)

Źródło:

SerializationInfo.cs

Dodaje wartość do SerializationInfo magazynu, z którym value jest skojarzona i name jest serializowana jako wartość 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

Nazwa, która ma zostać skojarzona z wartością, aby można ją było deserializować później.

value

Object

Wartość do serializacji. Wszystkie elementy podrzędne tego obiektu zostaną automatycznie serializowane.

type

Type

Element Type do skojarzenia z bieżącym obiektem. Ten parametr musi zawsze być typem samego obiektu lub jednej z jego klas bazowych.

Wyjątki

ArgumentNullException

Jeśli name lub type ma nullwartość .

SerializationException

Wartość została już skojarzona z elementem name.

Uwagi

Przypisany typ jest zawsze typem obiektu lub jednym z jego elementów nadrzędnych.

Jeśli dwie wartości są dodawane z nazwami, które różnią się tylko wielkością liter, nie zostanie zgłoszony żaden wyjątek, co nie jest zalecaną praktyką. Jednak dodanie dwóch wartości o dokładnie takiej samej nazwie spowoduje zgłoszenie wartości SerializationException .

AddValue(String, UInt64)

Źródło:

SerializationInfo.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Dodaje 64-bitową niepodpisaną wartość całkowitą do SerializationInfo magazynu.

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

Nazwa, która ma zostać skojarzona z wartością, aby można ją było deserializować później.

value

UInt64

Wartość do serializacji.

Atrybuty

CLSCompliantAttribute

Wyjątki

ArgumentNullException

Parametr name to null.

SerializationException

Wartość została już skojarzona z elementem name.

Uwagi

Jeśli dwie wartości są dodawane z nazwami, które różnią się tylko wielkością liter, nie zostanie zgłoszony żaden wyjątek, co nie jest zalecaną praktyką. Jednak dodanie dwóch wartości o dokładnie takiej samej nazwie spowoduje zgłoszenie wartości SerializationException .

AddValue(String, UInt32)

Źródło:

SerializationInfo.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Dodaje 32-bitową niepodpisaną wartość całkowitą do SerializationInfo magazynu.

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

Nazwa, która ma zostać skojarzona z wartością, aby można ją było deserializować później.

value

UInt32

Wartość UInt32 do serializacji.

Atrybuty

CLSCompliantAttribute

Wyjątki

ArgumentNullException

Parametr name to null.

SerializationException

Wartość została już skojarzona z elementem name.

Uwagi

Jeśli dwie wartości są dodawane z nazwami, które różnią się tylko wielkością liter, nie zostanie zgłoszony żaden wyjątek, co nie jest zalecaną praktyką. Jednak dodanie dwóch wartości o dokładnie takiej samej nazwie spowoduje zgłoszenie wartości SerializationException .

AddValue(String, UInt16)

Źródło:

SerializationInfo.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Dodaje 16-bitową niepodpisaną wartość całkowitą do SerializationInfo magazynu.

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

Nazwa, która ma zostać skojarzona z wartością, aby można ją było deserializować później.

value

UInt16

Wartość UInt16 do serializacji.

Atrybuty

CLSCompliantAttribute

Wyjątki

ArgumentNullException

Parametr name to null.

SerializationException

Wartość została już skojarzona z elementem name.

Uwagi

Jeśli dwie wartości są dodawane z nazwami, które różnią się tylko wielkością liter, nie zostanie zgłoszony żaden wyjątek, co nie jest zalecaną praktyką. Jednak dodanie dwóch wartości o dokładnie takiej samej nazwie spowoduje zgłoszenie wartości SerializationException .

AddValue(String, Single)

Źródło:

SerializationInfo.cs

Dodaje wartość zmiennoprzecinkową o pojedynczej precyzji SerializationInfo do magazynu.

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

Nazwa, która ma zostać skojarzona z wartością, aby można ją było deserializować później.

value

Single

Pojedyncza wartość do serializacji.

Wyjątki

ArgumentNullException

Parametr name to null.

SerializationException

Wartość została już skojarzona z elementem name.

Uwagi

Jeśli dwie wartości są dodawane z nazwami, które różnią się tylko wielkością liter, nie zostanie zgłoszony żaden wyjątek, co nie jest zalecaną praktyką. Jednak dodanie dwóch wartości o dokładnie takiej samej nazwie spowoduje zgłoszenie wartości SerializationException .

AddValue(String, SByte)

Źródło:

SerializationInfo.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Dodaje 8-bitową wartość całkowitą ze znakiem SerializationInfo do magazynu.

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

Nazwa, która ma zostać skojarzona z wartością, aby można ją było deserializować później.

value

SByte

Wartość Sbyte do serializacji.

Atrybuty

CLSCompliantAttribute

Wyjątki

ArgumentNullException

Parametr name to null.

SerializationException

Wartość została już skojarzona z elementem name.

Uwagi

Jeśli dwie wartości są dodawane z nazwami, które różnią się tylko wielkością liter, nie zostanie zgłoszony żaden wyjątek, co nie jest zalecaną praktyką. Jednak dodanie dwóch wartości o dokładnie takiej samej nazwie spowoduje zgłoszenie wartości SerializationException .

AddValue(String, Object)

Źródło:

SerializationInfo.cs

Dodaje określony obiekt do SerializationInfo magazynu, gdzie jest skojarzony z określoną nazwą.

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

Nazwa, która ma zostać skojarzona z wartością, aby można ją było deserializować później.

value

Object

Wartość do serializacji. Wszystkie elementy podrzędne tego obiektu zostaną automatycznie serializowane.

Wyjątki

ArgumentNullException

name to null.

SerializationException

Wartość została już skojarzona z elementem name.

Uwagi

Obiekt zawarty w parametrze value jest serializowany jako typ zwracany przez value.

Jeśli dwie wartości są dodawane z nazwami, które różnią się tylko wielkością liter, nie zostanie zgłoszony żaden wyjątek, co nie jest zalecaną praktyką. Jednak dodanie dwóch wartości o dokładnie takiej samej nazwie spowoduje zgłoszenie wartości SerializationException .

AddValue(String, Int64)

Źródło:

SerializationInfo.cs

Dodaje 64-bitową wartość całkowitą ze znakiem SerializationInfo do magazynu.

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

Nazwa, która ma zostać skojarzona z wartością, aby można ją było deserializować później.

value

Int64

Wartość Int64 do serializacji.

Wyjątki

ArgumentNullException

Parametr name to null.

SerializationException

Wartość została już skojarzona z elementem name.

Uwagi

Jeśli dwie wartości są dodawane z nazwami, które różnią się tylko wielkością liter, nie zostanie zgłoszony żaden wyjątek, co nie jest zalecaną praktyką. Jednak dodanie dwóch wartości o dokładnie takiej samej nazwie spowoduje zgłoszenie wartości SerializationException .

AddValue(String, Int32)

Źródło:

SerializationInfo.cs

Dodaje 32-bitową wartość całkowitą ze znakiem SerializationInfo do magazynu.

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

Nazwa, która ma zostać skojarzona z wartością, aby można ją było deserializować później.

value

Int32

Wartość Int32 do serializacji.

Wyjątki

ArgumentNullException

Parametr name to null.

SerializationException

Wartość została już skojarzona z elementem name.

Uwagi

Jeśli dwie wartości są dodawane z nazwami, które różnią się tylko wielkością liter, nie zostanie zgłoszony żaden wyjątek, co nie jest zalecaną praktyką. Jednak dodanie dwóch wartości o dokładnie takiej samej nazwie spowoduje zgłoszenie wartości SerializationException .

AddValue(String, Int16)

Źródło:

SerializationInfo.cs

Dodaje 16-bitową wartość całkowitą ze znakiem SerializationInfo do magazynu.

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

Nazwa, która ma zostać skojarzona z wartością, aby można ją było deserializować później.

value

Int16

Wartość Int16 do serializacji.

Wyjątki

ArgumentNullException

Parametr name to null.

SerializationException

Wartość została już skojarzona z elementem name.

Uwagi

Jeśli dwie wartości są dodawane z nazwami, które różnią się tylko wielkością liter, nie zostanie zgłoszony żaden wyjątek, co nie jest zalecaną praktyką. Jednak dodanie dwóch wartości o dokładnie takiej samej nazwie spowoduje zgłoszenie wartości SerializationException .

AddValue(String, Double)

Źródło:

SerializationInfo.cs

Dodaje do magazynu wartość zmiennoprzecinkową o podwójnej precyzji 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

Nazwa, która ma zostać skojarzona z wartością, aby można ją było deserializować później.

value

Double

Podwójna wartość do serializacji.

Wyjątki

ArgumentNullException

Parametr name to null.

SerializationException

Wartość została już skojarzona z elementem name.

Uwagi

Jeśli dwie wartości są dodawane z nazwami, które różnią się tylko wielkością liter, nie zostanie zgłoszony żaden wyjątek, co nie jest zalecaną praktyką. Jednak dodanie dwóch wartości o dokładnie takiej samej nazwie spowoduje zgłoszenie wartości SerializationException .

AddValue(String, Decimal)

Źródło:

SerializationInfo.cs

Dodaje wartość dziesiętną do SerializationInfo magazynu.

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

Nazwa, która ma zostać skojarzona z wartością, aby można ją było deserializować później.

value

Decimal

Wartość dziesiętna do serializacji.

Wyjątki

ArgumentNullException

name Jeśli parametr to null.

SerializationException

Jeśli wartość została już skojarzona z elementem name.

Uwagi

Jeśli dwie wartości są dodawane z nazwami, które różnią się tylko wielkością liter, nie zostanie zgłoszony żaden wyjątek, co nie jest zalecaną praktyką. Jednak dodanie dwóch wartości o dokładnie takiej samej nazwie spowoduje zgłoszenie wartości SerializationException .

AddValue(String, DateTime)

Źródło:

SerializationInfo.cs

DateTime Dodaje wartość do SerializationInfo magazynu.

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

Nazwa, która ma zostać skojarzona z wartością, aby można ją było deserializować później.

value

DateTime

Wartość DateTime do serializacji.

Wyjątki

ArgumentNullException

Parametr name to null.

SerializationException

Wartość została już skojarzona z elementem name.

Uwagi

Jeśli dwie wartości są dodawane z nazwami, które różnią się tylko wielkością liter, nie zostanie zgłoszony żaden wyjątek, co nie jest zalecaną praktyką. Jednak dodanie dwóch wartości o dokładnie takiej samej nazwie spowoduje zgłoszenie wartości SerializationException .

AddValue(String, Char)

Źródło:

SerializationInfo.cs

Dodaje wartość znaku Unicode do SerializationInfo magazynu.

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

Nazwa, która ma zostać skojarzona z wartością, aby można ją było deserializować później.

value

Char

Wartość znaku do serializacji.

Wyjątki

ArgumentNullException

Parametr name to null.

SerializationException

Wartość została już skojarzona z elementem name.

Uwagi

Jeśli dwie wartości są dodawane z nazwami, które różnią się tylko wielkością liter, nie zostanie zgłoszony żaden wyjątek, co nie jest zalecaną praktyką. Jednak dodanie dwóch wartości o dokładnie takiej samej nazwie spowoduje zgłoszenie wartości SerializationException .

AddValue(String, Byte)

Źródło:

SerializationInfo.cs

Dodaje 8-bitową wartość całkowitą bez znaku do SerializationInfo magazynu.

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

Nazwa, która ma zostać skojarzona z wartością, aby można ją było deserializować później.

value

Byte

Wartość bajtu do serializacji.

Wyjątki

ArgumentNullException

Parametr name to null.

SerializationException

Wartość została już skojarzona z elementem name.

Uwagi

Jeśli dwie wartości są dodawane z nazwami, które różnią się tylko wielkością liter, nie zostanie zgłoszony żaden wyjątek, co nie jest zalecaną praktyką. Jednak dodanie dwóch wartości o dokładnie takiej samej nazwie spowoduje zgłoszenie wartości SerializationException .

AddValue(String, Boolean)

Źródło:

SerializationInfo.cs

Dodaje wartość logiczną do SerializationInfo magazynu.

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

Nazwa, która ma zostać skojarzona z wartością, aby można ją było deserializować później.

value

Boolean

Wartość logiczna do serializacji.

Wyjątki

ArgumentNullException

Parametr name to null.

SerializationException

Wartość została już skojarzona z elementem name.

Uwagi

Jeśli dwie wartości są dodawane z nazwami, które różnią się tylko wielkością liter, nie zostanie zgłoszony żaden wyjątek, co nie jest zalecaną praktyką. Jednak dodanie dwóch wartości o dokładnie takiej samej nazwie spowoduje zgłoszenie wartości SerializationException . Na przykład:

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