SerializationInfo.AddValue Metode

Definisi

Ruang nama:

System.Runtime.Serialization

Rakitan:

System.Runtime.dll

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

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

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

ArgumentNullException

Jika name atau type adalah null.

SerializationException

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 .

AddValue(String, UInt64)

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

CLSCompliantAttribute

Pengecualian

ArgumentNullException

Parameternya name adalah null.

SerializationException

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 .

AddValue(String, UInt32)

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

CLSCompliantAttribute

Pengecualian

ArgumentNullException

Parameternya name adalah null.

SerializationException

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 .

AddValue(String, UInt16)

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

CLSCompliantAttribute

Pengecualian

ArgumentNullException

Parameternya name adalah null.

SerializationException

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 .

AddValue(String, Single)

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

ArgumentNullException

Parameternya name adalah null.

SerializationException

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 .

AddValue(String, SByte)

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

CLSCompliantAttribute

Pengecualian

ArgumentNullException

Parameternya name adalah null.

SerializationException

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 .

AddValue(String, Object)

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

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

ArgumentNullException

nameadalah null.

SerializationException

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 .

AddValue(String, Int64)

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

ArgumentNullException

Parameternya name adalah null.

SerializationException

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 .

AddValue(String, Int32)

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

ArgumentNullException

Parameternya name adalah null.

SerializationException

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 .

AddValue(String, Int16)

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

ArgumentNullException

Parameternya name adalah null.

SerializationException

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 .

AddValue(String, Double)

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

ArgumentNullException

Parameternya name adalah null.

SerializationException

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 .

AddValue(String, Decimal)

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

ArgumentNullException

name Jika Parameternya adalah null.

SerializationException

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 .

AddValue(String, DateTime)

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

ArgumentNullException

Parameternya name adalah null.

SerializationException

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 .

AddValue(String, Char)

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

ArgumentNullException

Parameternya name adalah null.

SerializationException

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 .

AddValue(String, Byte)

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

ArgumentNullException

Parameternya name adalah null.

SerializationException

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 .

AddValue(String, Boolean)

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

ArgumentNullException

Parameternya name adalah null.

SerializationException

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