Bagikan melalui


SerializationInfo.AddValue Metode

Definisi

Menambahkan nilai ke SerializationInfodalam .

Overload

AddValue(String, Object, Type)

Menambahkan nilai ke SerializationInfo dalam penyimpanan, di mana value dikaitkan dengan name dan diserialisasikan sebagai .Typetype

AddValue(String, UInt64)

Menambahkan nilai bilangan bulat tidak bertanda 64-bit ke dalam penyimpanan SerializationInfo .

AddValue(String, UInt32)

Menambahkan nilai bilangan bulat tidak bertanda 32-bit ke dalam penyimpanan SerializationInfo .

AddValue(String, UInt16)

Menambahkan nilai bilangan bulat yang tidak ditandatangani 16-bit ke dalam penyimpanan SerializationInfo .

AddValue(String, Single)

Menambahkan nilai floating-point presisi tunggal ke dalam penyimpanan SerializationInfo .

AddValue(String, SByte)

Menambahkan nilai bilangan bulat bertanda tangan 8-bit ke dalam penyimpanan SerializationInfo .

AddValue(String, Object)

Menambahkan objek yang ditentukan ke dalam penyimpanan SerializationInfo , di mana objek tersebut dikaitkan dengan nama tertentu.

AddValue(String, Int64)

Menambahkan nilai bilangan bulat bertanda tangan 64-bit ke dalam penyimpanan SerializationInfo .

AddValue(String, Int32)

Menambahkan nilai bilangan bulat bertanda tangan 32-bit ke dalam penyimpanan SerializationInfo .

AddValue(String, Int16)

Menambahkan nilai bilangan bulat bertanda tangan 16-bit ke dalam penyimpanan SerializationInfo .

AddValue(String, Double)

Menambahkan nilai floating-point presisi ganda ke dalam penyimpanan SerializationInfo .

AddValue(String, Decimal)

Menambahkan nilai desimal ke dalam penyimpanan SerializationInfo .

AddValue(String, DateTime)

DateTime Menambahkan nilai ke dalam penyimpananSerializationInfo.

AddValue(String, Char)

Menambahkan nilai karakter Unicode ke dalam penyimpanan SerializationInfo .

AddValue(String, Byte)

Menambahkan nilai bilangan bulat yang tidak ditandatangani 8-bit ke dalam penyimpanan SerializationInfo .

AddValue(String, Boolean)

Menambahkan nilai Boolean ke dalam penyimpanan SerializationInfo .

AddValue(String, Object, Type)

Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs

Menambahkan nilai ke SerializationInfo dalam penyimpanan, di mana value dikaitkan dengan name dan diserialisasikan sebagai .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)

Parameter

name
String

Nama yang akan dikaitkan dengan nilai, sehingga dapat dideserialisasi nanti.

value
Object

Nilai yang akan diserialisasikan. Setiap anak dari objek ini akan secara otomatis diserialisasikan.

type
Type

Type untuk mengaitkan dengan objek saat ini. Parameter ini harus selalu menjadi jenis objek itu sendiri atau dari salah satu kelas dasarnya.

Pengecualian

Jika name atau type adalah null.

Nilai telah dikaitkan dengan name.

Keterangan

Jenis yang ditetapkan selalu merupakan jenis objek, atau salah satu induknya.

Jika dua nilai ditambahkan dengan nama yang hanya berbeda menurut kasus, tidak ada pengecualian yang akan dilemparkan, yang bukan praktik yang direkomendasikan. Namun, menambahkan dua nilai dengan nama yang sama persis akan menyebabkan dilemparkan SerializationException .

Berlaku untuk

AddValue(String, UInt64)

Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs

Penting

API ini bukan kompatibel CLS.

Menambahkan nilai bilangan bulat tidak bertanda 64-bit ke dalam penyimpanan 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)

Parameter

name
String

Nama yang akan dikaitkan dengan nilai, sehingga dapat dideserialisasi nanti.

value
UInt64

Nilai untuk diserialisasikan.

Atribut

Pengecualian

Parameternya name adalah null.

Nilai telah dikaitkan dengan name.

Keterangan

Jika dua nilai ditambahkan dengan nama yang hanya berbeda menurut kasus, tidak ada pengecualian yang akan dilemparkan, yang bukan praktik yang direkomendasikan. Namun, menambahkan dua nilai dengan nama yang sama persis akan menyebabkan dilemparkan SerializationException .

Berlaku untuk

AddValue(String, UInt32)

Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs

Penting

API ini bukan kompatibel CLS.

Menambahkan nilai bilangan bulat tidak bertanda 32-bit ke dalam penyimpanan 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)

Parameter

name
String

Nama yang akan dikaitkan dengan nilai, sehingga dapat dideserialisasi nanti.

value
UInt32

Nilai UInt32 untuk diserialisasikan.

Atribut

Pengecualian

Parameternya name adalah null.

Nilai telah dikaitkan dengan name.

Keterangan

Jika dua nilai ditambahkan dengan nama yang hanya berbeda menurut kasus, tidak ada pengecualian yang akan dilemparkan, yang bukan praktik yang direkomendasikan. Namun, menambahkan dua nilai dengan nama yang sama persis akan menyebabkan dilemparkan SerializationException .

Berlaku untuk

AddValue(String, UInt16)

Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs

Penting

API ini bukan kompatibel CLS.

Menambahkan nilai bilangan bulat yang tidak ditandatangani 16-bit ke dalam penyimpanan 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)

Parameter

name
String

Nama yang akan dikaitkan dengan nilai, sehingga dapat dideserialisasi nanti.

value
UInt16

Nilai UInt16 untuk diserialisasikan.

Atribut

Pengecualian

Parameternya name adalah null.

Nilai telah dikaitkan dengan name.

Keterangan

Jika dua nilai ditambahkan dengan nama yang hanya berbeda menurut kasus, tidak ada pengecualian yang akan dilemparkan, yang bukan praktik yang direkomendasikan. Namun, menambahkan dua nilai dengan nama yang sama persis akan menyebabkan dilemparkan SerializationException .

Berlaku untuk

AddValue(String, Single)

Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs

Menambahkan nilai floating-point presisi tunggal ke dalam penyimpanan 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)

Parameter

name
String

Nama yang akan dikaitkan dengan nilai, sehingga dapat dideserialisasi nanti.

value
Single

Nilai tunggal untuk diserialisasikan.

Pengecualian

Parameternya name adalah null.

Nilai telah dikaitkan dengan name.

Keterangan

Jika dua nilai ditambahkan dengan nama yang hanya berbeda menurut kasus, tidak ada pengecualian yang akan dilemparkan, yang bukan praktik yang direkomendasikan. Namun, menambahkan dua nilai dengan nama yang sama persis akan menyebabkan dilemparkan SerializationException .

Berlaku untuk

AddValue(String, SByte)

Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs

Penting

API ini bukan kompatibel CLS.

Menambahkan nilai bilangan bulat bertanda tangan 8-bit ke dalam penyimpanan SerializationInfo .

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)

Parameter

name
String

Nama yang akan dikaitkan dengan nilai, sehingga dapat dideserialisasi nanti.

value
SByte

Nilai Sbyte untuk diserialisasikan.

Atribut

Pengecualian

Parameternya name adalah null.

Nilai telah dikaitkan dengan name.

Keterangan

Jika dua nilai ditambahkan dengan nama yang hanya berbeda menurut kasus, tidak ada pengecualian yang akan dilemparkan, yang bukan praktik yang direkomendasikan. Namun, menambahkan dua nilai dengan nama yang sama persis akan menyebabkan dilemparkan SerializationException .

Berlaku untuk

AddValue(String, Object)

Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs

Menambahkan objek yang ditentukan ke dalam penyimpanan SerializationInfo , di mana objek tersebut dikaitkan dengan nama tertentu.

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)

Parameter

name
String

Nama yang akan dikaitkan dengan nilai, sehingga dapat dideserialisasi nanti.

value
Object

Nilai yang akan diserialisasikan. Setiap anak dari objek ini akan secara otomatis diserialisasikan.

Pengecualian

nameadalah null.

Nilai telah dikaitkan dengan name.

Keterangan

Objek yang terkandung dalam parameter diserialisasikan value sebagai jenis yang dikembalikan oleh value.

Jika dua nilai ditambahkan dengan nama yang hanya berbeda menurut kasus, tidak ada pengecualian yang akan dilemparkan, yang bukan praktik yang direkomendasikan. Namun, menambahkan dua nilai dengan nama yang sama persis akan menyebabkan dilemparkan SerializationException .

Berlaku untuk

AddValue(String, Int64)

Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs

Menambahkan nilai bilangan bulat bertanda tangan 64-bit ke dalam penyimpanan 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)

Parameter

name
String

Nama yang akan dikaitkan dengan nilai, sehingga dapat dideserialisasi nanti.

value
Int64

Nilai Int64 untuk diserialisasikan.

Pengecualian

Parameternya name adalah null.

Nilai telah dikaitkan dengan name.

Keterangan

Jika dua nilai ditambahkan dengan nama yang hanya berbeda menurut kasus, tidak ada pengecualian yang akan dilemparkan, yang bukan praktik yang direkomendasikan. Namun, menambahkan dua nilai dengan nama yang sama persis akan menyebabkan dilemparkan SerializationException .

Berlaku untuk

AddValue(String, Int32)

Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs

Menambahkan nilai bilangan bulat bertanda tangan 32-bit ke dalam penyimpanan SerializationInfo .

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)

Parameter

name
String

Nama yang akan dikaitkan dengan nilai, sehingga dapat dideserialisasi nanti.

value
Int32

Nilai Int32 untuk diserialisasikan.

Pengecualian

Parameternya name adalah null.

Nilai telah dikaitkan dengan name.

Keterangan

Jika dua nilai ditambahkan dengan nama yang hanya berbeda menurut kasus, tidak ada pengecualian yang akan dilemparkan, yang bukan praktik yang direkomendasikan. Namun, menambahkan dua nilai dengan nama yang sama persis akan menyebabkan dilemparkan SerializationException .

Berlaku untuk

AddValue(String, Int16)

Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs

Menambahkan nilai bilangan bulat bertanda tangan 16-bit ke dalam penyimpanan 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)

Parameter

name
String

Nama yang akan dikaitkan dengan nilai, sehingga dapat dideserialisasi nanti.

value
Int16

Nilai Int16 untuk diserialisasikan.

Pengecualian

Parameternya name adalah null.

Nilai telah dikaitkan dengan name.

Keterangan

Jika dua nilai ditambahkan dengan nama yang hanya berbeda menurut kasus, tidak ada pengecualian yang akan dilemparkan, yang bukan praktik yang direkomendasikan. Namun, menambahkan dua nilai dengan nama yang sama persis akan menyebabkan dilemparkan SerializationException .

Berlaku untuk

AddValue(String, Double)

Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs

Menambahkan nilai floating-point presisi ganda ke dalam penyimpanan 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)

Parameter

name
String

Nama yang akan dikaitkan dengan nilai, sehingga dapat dideserialisasi nanti.

value
Double

Nilai ganda untuk diserialisasikan.

Pengecualian

Parameternya name adalah null.

Nilai telah dikaitkan dengan name.

Keterangan

Jika dua nilai ditambahkan dengan nama yang hanya berbeda menurut kasus, tidak ada pengecualian yang akan dilemparkan, yang bukan praktik yang direkomendasikan. Namun, menambahkan dua nilai dengan nama yang sama persis akan menyebabkan dilemparkan SerializationException .

Berlaku untuk

AddValue(String, Decimal)

Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs

Menambahkan nilai desimal ke dalam penyimpanan SerializationInfo .

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)

Parameter

name
String

Nama yang akan dikaitkan dengan nilai, sehingga dapat dideserialisasi nanti.

value
Decimal

Nilai desimal untuk diserialisasikan.

Pengecualian

name Jika Parameternya adalah null.

Jika nilai telah dikaitkan dengan name.

Keterangan

Jika dua nilai ditambahkan dengan nama yang hanya berbeda menurut kasus, tidak ada pengecualian yang akan dilemparkan, yang bukan praktik yang direkomendasikan. Namun, menambahkan dua nilai dengan nama yang sama persis akan menyebabkan dilemparkan SerializationException .

Berlaku untuk

AddValue(String, DateTime)

Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs

DateTime Menambahkan nilai ke dalam penyimpananSerializationInfo.

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)

Parameter

name
String

Nama yang akan dikaitkan dengan nilai, sehingga dapat dideserialisasi nanti.

value
DateTime

Nilai DateTime untuk diserialisasikan.

Pengecualian

Parameternya name adalah null.

Nilai telah dikaitkan dengan name.

Keterangan

Jika dua nilai ditambahkan dengan nama yang hanya berbeda menurut kasus, tidak ada pengecualian yang akan dilemparkan, yang bukan praktik yang direkomendasikan. Namun, menambahkan dua nilai dengan nama yang sama persis akan menyebabkan dilemparkan SerializationException .

Berlaku untuk

AddValue(String, Char)

Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs

Menambahkan nilai karakter Unicode ke dalam penyimpanan SerializationInfo .

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)

Parameter

name
String

Nama yang akan dikaitkan dengan nilai, sehingga dapat dideserialisasi nanti.

value
Char

Nilai karakter yang akan diserialisasikan.

Pengecualian

Parameternya name adalah null.

Nilai telah dikaitkan dengan name.

Keterangan

Jika dua nilai ditambahkan dengan nama yang hanya berbeda menurut kasus, tidak ada pengecualian yang akan dilemparkan, yang bukan praktik yang direkomendasikan. Namun, menambahkan dua nilai dengan nama yang sama persis akan menyebabkan dilemparkan SerializationException .

Berlaku untuk

AddValue(String, Byte)

Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs

Menambahkan nilai bilangan bulat yang tidak ditandatangani 8-bit ke dalam penyimpanan 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)

Parameter

name
String

Nama yang akan dikaitkan dengan nilai, sehingga dapat dideserialisasi nanti.

value
Byte

Nilai byte untuk diserialisasikan.

Pengecualian

Parameternya name adalah null.

Nilai telah dikaitkan dengan name.

Keterangan

Jika dua nilai ditambahkan dengan nama yang hanya berbeda menurut kasus, tidak ada pengecualian yang akan dilemparkan, yang bukan praktik yang direkomendasikan. Namun, menambahkan dua nilai dengan nama yang sama persis akan menyebabkan dilemparkan SerializationException .

Berlaku untuk

AddValue(String, Boolean)

Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs
Sumber:
SerializationInfo.cs

Menambahkan nilai Boolean ke dalam penyimpanan SerializationInfo .

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)

Parameter

name
String

Nama yang akan dikaitkan dengan nilai, sehingga dapat dideserialisasi nanti.

value
Boolean

Nilai Boolean untuk diserialisasikan.

Pengecualian

Parameternya name adalah null.

Nilai telah dikaitkan dengan name.

Keterangan

Jika dua nilai ditambahkan dengan nama yang hanya berbeda menurut kasus, tidak ada pengecualian yang akan dilemparkan, yang bukan praktik yang direkomendasikan. Namun, menambahkan dua nilai dengan nama yang sama persis akan menyebabkan dilemparkan SerializationException . Contohnya:

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  

Berlaku untuk