Udostępnij za pośrednictwem


SerializationInfo.AddValue Metoda

Definicja

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

Jeśli name lub type ma nullwartość .

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

Wyjątki

Parametr name to null.

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 .

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

Wyjątki

Parametr name to null.

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 .

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

Wyjątki

Parametr name to null.

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 .

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

Parametr name to null.

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 .

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

Wyjątki

Parametr name to null.

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 .

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

name to null.

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 .

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

Parametr name to null.

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 .

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

Parametr name to null.

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 .

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

Parametr name to null.

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 .

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

Parametr name to null.

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 .

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

name Jeśli parametr to null.

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 .

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

Parametr name to null.

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 .

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

Parametr name to null.

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 .

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

Parametr name to null.

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 .

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

Parametr name to null.

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  

Dotyczy