SerializationInfo.AddValue Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Runtime.Serialization

Zestaw:: System.Runtime.dll

Zestaw:: System.Runtime.Serialization.Formatters.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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ść Type`type`.
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

Źródło:: SerializationInfo.cs

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

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 .

Dotyczy

AddValue(String, UInt64)

Źródło:: SerializationInfo.cs

Źródło:: SerializationInfo.cs

Ź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

Dotyczy

AddValue(String, UInt32)

Źródło:: SerializationInfo.cs

Źródło:: SerializationInfo.cs

Ź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

Dotyczy

AddValue(String, UInt16)

Źródło:: SerializationInfo.cs

Źródło:: SerializationInfo.cs

Ź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

Dotyczy

AddValue(String, Single)

Źródło:: SerializationInfo.cs

Źródło:: SerializationInfo.cs

Ź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

Dotyczy

AddValue(String, SByte)

Źródło:: SerializationInfo.cs

Źródło:: SerializationInfo.cs

Ź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

Dotyczy

AddValue(String, Object)

Źródło:: SerializationInfo.cs

Źródło:: SerializationInfo.cs

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

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.

Dotyczy

AddValue(String, Int64)

Źródło:: SerializationInfo.cs

Źródło:: SerializationInfo.cs

Ź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

Dotyczy

AddValue(String, Int32)

Źródło:: SerializationInfo.cs

Źródło:: SerializationInfo.cs

Ź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

Dotyczy

AddValue(String, Int16)

Źródło:: SerializationInfo.cs

Źródło:: SerializationInfo.cs

Ź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

Dotyczy

AddValue(String, Double)

Źródło:: SerializationInfo.cs

Źródło:: SerializationInfo.cs

Ź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

Dotyczy

AddValue(String, Decimal)

Źródło:: SerializationInfo.cs

Źródło:: SerializationInfo.cs

Ź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

Dotyczy

AddValue(String, DateTime)

Źródło:: SerializationInfo.cs

Źródło:: SerializationInfo.cs

Ź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

Dotyczy

AddValue(String, Char)

Źródło:: SerializationInfo.cs

Źródło:: SerializationInfo.cs

Ź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

Dotyczy

AddValue(String, Byte)

Źródło:: SerializationInfo.cs

Źródło:: SerializationInfo.cs

Ź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

Dotyczy

AddValue(String, Boolean)

Źródło:: SerializationInfo.cs

Źródło:: SerializationInfo.cs

Ź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

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

Dotyczy