SerializationInfo.AddValue Yöntem

Tanım

Ad Alanı:

System.Runtime.Serialization

Bütünleştirilmiş Kod:

System.Runtime.dll

içine SerializationInfobir değer ekler.

Aşırı Yüklemeler

AddValue(String, Object, Type)	depoya SerializationInfo bir değer ekler, burada value ile name ilişkilendirilir ve değeri Typetypeolarak serileştirilir.
AddValue(String, UInt64)	Depoya SerializationInfo 64 bit işaretsiz bir tamsayı değeri ekler.
AddValue(String, UInt32)	Depoya SerializationInfo 32 bit işaretsiz bir tamsayı değeri ekler.
AddValue(String, UInt16)	Depoya SerializationInfo 16 bit işaretsiz bir tamsayı değeri ekler.
AddValue(String, Single)	Depoya tek duyarlıklı kayan SerializationInfo nokta değeri ekler.
AddValue(String, SByte)	Depoya SerializationInfo 8 bit imzalı bir tamsayı değeri ekler.
AddValue(String, Object)	Belirtilen nesneyi, belirtilen bir adla ilişkilendirildiği depoya SerializationInfo ekler.
AddValue(String, Int64)	Depoya SerializationInfo 64 bit imzalı bir tamsayı değeri ekler.
AddValue(String, Int32)	Depoya SerializationInfo 32 bit imzalı bir tamsayı değeri ekler.
AddValue(String, Int16)	Depoya SerializationInfo 16 bit imzalı bir tamsayı değeri ekler.
AddValue(String, Double)	Depoya çift duyarlıklı kayan SerializationInfo nokta değeri ekler.
AddValue(String, Decimal)	Depoya SerializationInfo ondalık değer ekler.
AddValue(String, DateTime)	Depoya SerializationInfo bir DateTime değer ekler.
AddValue(String, Char)	Depoya SerializationInfo bir Unicode karakter değeri ekler.
AddValue(String, Byte)	Depoya SerializationInfo 8 bit işaretsiz bir tamsayı değeri ekler.
AddValue(String, Boolean)	Depoya SerializationInfo bir Boole değeri ekler.

AddValue(String, Object, Type)

Kaynak:

SerializationInfo.cs

depoya SerializationInfo bir değer ekler, burada value ile name ilişkilendirilir ve değeri Typetypeolarak serileştirilir.

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)

Parametreler

name

String

Daha sonra seri durumdan çıkarılabilmesi için değerle ilişkilendirilecek ad.

value

Object

Seri hale getirilecek değer. Bu nesnenin tüm alt öğeleri otomatik olarak seri hale getirilir.

type

Type

Type Geçerli nesneyle ilişkilendirilecek. Bu parametre her zaman nesnenin türü veya temel sınıflarından biri olmalıdır.

Özel durumlar

ArgumentNullException

veya nametype ise null.

SerializationException

Bir değer ile namezaten ilişkilendirilmiştir.

Açıklamalar

Atanan tür her zaman nesnenin veya üst öğesinden birinin türüdür.

Yalnızca büyük/küçük harfe göre farklı adlarla iki değer eklenirse, önerilen bir uygulama olmayan özel durum oluşturmaz. Ancak, tam olarak aynı ada sahip iki değerin eklenmesi, değerinin SerializationException atmasına neden olur.

AddValue(String, UInt64)

Kaynak:

SerializationInfo.cs

Önemli

Bu API, CLS uyumlu değildir.

Depoya SerializationInfo 64 bit işaretsiz bir tamsayı değeri ekler.

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)

Parametreler

name

String

Daha sonra seri durumdan çıkarılabilmesi için değerle ilişkilendirilecek ad.

value

UInt64

Serileştirecek değer.

Öznitelikler

CLSCompliantAttribute

Özel durumlar

ArgumentNullException

name parametresidirnull.

SerializationException

Bir değer ile namezaten ilişkilendirilmiştir.

Açıklamalar

Yalnızca büyük/küçük harfe göre farklı adlarla iki değer eklenirse, önerilen bir uygulama olmayan özel durum oluşturmaz. Ancak, tam olarak aynı ada sahip iki değerin eklenmesi, değerinin SerializationException atmasına neden olur.

AddValue(String, UInt32)

Kaynak:

SerializationInfo.cs

Önemli

Bu API, CLS uyumlu değildir.

Depoya SerializationInfo 32 bit işaretsiz bir tamsayı değeri ekler.

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)

Parametreler

name

String

Daha sonra seri durumdan çıkarılabilmesi için değerle ilişkilendirilecek ad.

value

UInt32

Serileştirecek UInt32 değer.

Öznitelikler

CLSCompliantAttribute

Özel durumlar

ArgumentNullException

name parametresidirnull.

SerializationException

Bir değer ile namezaten ilişkilendirilmiştir.

Açıklamalar

Yalnızca büyük/küçük harfe göre farklı adlarla iki değer eklenirse, önerilen bir uygulama olmayan özel durum oluşturmaz. Ancak, tam olarak aynı ada sahip iki değerin eklenmesi, değerinin SerializationException atmasına neden olur.

AddValue(String, UInt16)

Kaynak:

SerializationInfo.cs

Önemli

Bu API, CLS uyumlu değildir.

Depoya SerializationInfo 16 bit işaretsiz bir tamsayı değeri ekler.

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)

Parametreler

name

String

Daha sonra seri durumdan çıkarılabilmesi için değerle ilişkilendirilecek ad.

value

UInt16

Serileştirecek UInt16 değer.

Öznitelikler

CLSCompliantAttribute

Özel durumlar

ArgumentNullException

name parametresidirnull.

SerializationException

Bir değer ile namezaten ilişkilendirilmiştir.

Açıklamalar

Yalnızca büyük/küçük harfe göre farklı adlarla iki değer eklenirse, önerilen bir uygulama olmayan özel durum oluşturmaz. Ancak, tam olarak aynı ada sahip iki değerin eklenmesi, değerinin SerializationException atmasına neden olur.

AddValue(String, Single)

Kaynak:

SerializationInfo.cs

Depoya tek duyarlıklı kayan SerializationInfo nokta değeri ekler.

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)

Parametreler

name

String

Daha sonra seri durumdan çıkarılabilmesi için değerle ilişkilendirilecek ad.

value

Single

Seri hale getirmek için tek değer.

Özel durumlar

ArgumentNullException

name parametresidirnull.

SerializationException

Bir değer ile namezaten ilişkilendirilmiştir.

Açıklamalar

Yalnızca büyük/küçük harfe göre farklı adlarla iki değer eklenirse, önerilen bir uygulama olmayan özel durum oluşturmaz. Ancak, tam olarak aynı ada sahip iki değerin eklenmesi, değerinin SerializationException atmasına neden olur.

AddValue(String, SByte)

Kaynak:

SerializationInfo.cs

Önemli

Bu API, CLS uyumlu değildir.

Depoya SerializationInfo 8 bit imzalı bir tamsayı değeri ekler.

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)

Parametreler

name

String

Daha sonra seri durumdan çıkarılabilmesi için değerle ilişkilendirilecek ad.

value

SByte

Serileştirecek Sbyte değer.

Öznitelikler

CLSCompliantAttribute

Özel durumlar

ArgumentNullException

name parametresidirnull.

SerializationException

Bir değer ile namezaten ilişkilendirilmiştir.

Açıklamalar

Yalnızca büyük/küçük harfe göre farklı adlarla iki değer eklenirse, önerilen bir uygulama olmayan özel durum oluşturmaz. Ancak, tam olarak aynı ada sahip iki değerin eklenmesi, değerinin SerializationException atmasına neden olur.

AddValue(String, Object)

Kaynak:

SerializationInfo.cs

Belirtilen nesneyi, belirtilen bir adla ilişkilendirildiği depoya SerializationInfo ekler.

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)

Parametreler

name

String

Daha sonra seri durumdan çıkarılabilmesi için değerle ilişkilendirilecek ad.

value

Object

Seri hale getirilecek değer. Bu nesnenin tüm alt öğeleri otomatik olarak seri hale getirilir.

Özel durumlar

ArgumentNullException

name, null değeridir.

SerializationException

Bir değer ile namezaten ilişkilendirilmiştir.

Açıklamalar

parametresinde value bulunan nesne, tarafından valuedöndürülen tür olarak serileştirilir.

Yalnızca büyük/küçük harfe göre farklı adlarla iki değer eklenirse, önerilen bir uygulama olmayan özel durum oluşturmaz. Ancak, tam olarak aynı ada sahip iki değerin eklenmesi, değerinin SerializationException atmasına neden olur.

AddValue(String, Int64)

Kaynak:

SerializationInfo.cs

Depoya SerializationInfo 64 bit imzalı bir tamsayı değeri ekler.

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)

Parametreler

name

String

Daha sonra seri durumdan çıkarılabilmesi için değerle ilişkilendirilecek ad.

value

Int64

Seri hale getirmek için Int64 değeri.

Özel durumlar

ArgumentNullException

name parametresidirnull.

SerializationException

Bir değer ile namezaten ilişkilendirilmiştir.

Açıklamalar

Yalnızca büyük/küçük harfe göre farklı adlarla iki değer eklenirse, önerilen bir uygulama olmayan özel durum oluşturmaz. Ancak, tam olarak aynı ada sahip iki değerin eklenmesi, değerinin SerializationException atmasına neden olur.

AddValue(String, Int32)

Kaynak:

SerializationInfo.cs

Depoya SerializationInfo 32 bit imzalı bir tamsayı değeri ekler.

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)

Parametreler

name

String

Daha sonra seri durumdan çıkarılabilmesi için değerle ilişkilendirilecek ad.

value

Int32

Serileştirecek Int32 değer.

Özel durumlar

ArgumentNullException

name parametresidirnull.

SerializationException

Bir değer ile namezaten ilişkilendirilmiştir.

Açıklamalar

Yalnızca büyük/küçük harfe göre farklı adlarla iki değer eklenirse, önerilen bir uygulama olmayan özel durum oluşturmaz. Ancak, tam olarak aynı ada sahip iki değerin eklenmesi, değerinin SerializationException atmasına neden olur.

AddValue(String, Int16)

Kaynak:

SerializationInfo.cs

Depoya SerializationInfo 16 bit imzalı bir tamsayı değeri ekler.

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)

Parametreler

name

String

Daha sonra seri durumdan çıkarılabilmesi için değerle ilişkilendirilecek ad.

value

Int16

Serileştirecek Int16 değer.

Özel durumlar

ArgumentNullException

name parametresidirnull.

SerializationException

Bir değer ile namezaten ilişkilendirilmiştir.

Açıklamalar

Yalnızca büyük/küçük harfe göre farklı adlarla iki değer eklenirse, önerilen bir uygulama olmayan özel durum oluşturmaz. Ancak, tam olarak aynı ada sahip iki değerin eklenmesi, değerinin SerializationException atmasına neden olur.

AddValue(String, Double)

Kaynak:

SerializationInfo.cs

Depoya çift duyarlıklı kayan SerializationInfo nokta değeri ekler.

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)

Parametreler

name

String

Daha sonra seri durumdan çıkarılabilmesi için değerle ilişkilendirilecek ad.

value

Double

Seri hale getirmek için çift değer.

Özel durumlar

ArgumentNullException

name parametresidirnull.

SerializationException

Bir değer ile namezaten ilişkilendirilmiştir.

Açıklamalar

Yalnızca büyük/küçük harfe göre farklı adlarla iki değer eklenirse, önerilen bir uygulama olmayan özel durum oluşturmaz. Ancak, tam olarak aynı ada sahip iki değerin eklenmesi, değerinin SerializationException atmasına neden olur.

AddValue(String, Decimal)

Kaynak:

SerializationInfo.cs

Depoya SerializationInfo ondalık değer ekler.

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)

Parametreler

name

String

Daha sonra seri durumdan çıkarılabilmesi için değerle ilişkilendirilecek ad.

value

Decimal

Serileştirecek ondalık değer.

Özel durumlar

ArgumentNullException

name Parametresi isenull.

SerializationException

Bir değer ile namezaten ilişkilendirildiyse.

Açıklamalar

Yalnızca büyük/küçük harfe göre farklı adlarla iki değer eklenirse, önerilen bir uygulama olmayan özel durum oluşturmaz. Ancak, tam olarak aynı ada sahip iki değerin eklenmesi, değerinin SerializationException atmasına neden olur.

AddValue(String, DateTime)

Kaynak:

SerializationInfo.cs

Depoya SerializationInfo bir DateTime değer ekler.

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)

Parametreler

name

String

Daha sonra seri durumdan çıkarılabilmesi için değerle ilişkilendirilecek ad.

value

DateTime

Serileştirecek DateTime değer.

Özel durumlar

ArgumentNullException

name parametresidirnull.

SerializationException

Bir değer ile namezaten ilişkilendirilmiştir.

Açıklamalar

Yalnızca büyük/küçük harfe göre farklı adlarla iki değer eklenirse, önerilen bir uygulama olmayan özel durum oluşturmaz. Ancak, tam olarak aynı ada sahip iki değerin eklenmesi, değerinin SerializationException atmasına neden olur.

AddValue(String, Char)

Kaynak:

SerializationInfo.cs

Depoya SerializationInfo bir Unicode karakter değeri ekler.

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)

Parametreler

name

String

Daha sonra seri durumdan çıkarılabilmesi için değerle ilişkilendirilecek ad.

value

Char

Serileştirecek karakter değeri.

Özel durumlar

ArgumentNullException

name parametresidirnull.

SerializationException

Bir değer ile namezaten ilişkilendirilmiştir.

Açıklamalar

Yalnızca büyük/küçük harfe göre farklı adlarla iki değer eklenirse, önerilen bir uygulama olmayan özel durum oluşturmaz. Ancak, tam olarak aynı ada sahip iki değerin eklenmesi, değerinin SerializationException atmasına neden olur.

AddValue(String, Byte)

Kaynak:

SerializationInfo.cs

Depoya SerializationInfo 8 bit işaretsiz bir tamsayı değeri ekler.

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)

Parametreler

name

String

Daha sonra seri durumdan çıkarılabilmesi için değerle ilişkilendirilecek ad.

value

Byte

Serileştirecek bayt değeri.

Özel durumlar

ArgumentNullException

name parametresidirnull.

SerializationException

Bir değer ile namezaten ilişkilendirilmiştir.

Açıklamalar

Yalnızca büyük/küçük harfe göre farklı adlarla iki değer eklenirse, önerilen bir uygulama olmayan özel durum oluşturmaz. Ancak, tam olarak aynı ada sahip iki değerin eklenmesi, değerinin SerializationException atmasına neden olur.

AddValue(String, Boolean)

Kaynak:

SerializationInfo.cs

Depoya SerializationInfo bir Boole değeri ekler.

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)

Parametreler

name

String

Daha sonra seri durumdan çıkarılabilmesi için değerle ilişkilendirilecek ad.

value

Boolean

Serileştirecek Boole değeri.

Özel durumlar

ArgumentNullException

name parametresidirnull.

SerializationException

Bir değer ile namezaten ilişkilendirilmiştir.

Açıklamalar

Yalnızca büyük/küçük harfe göre farklı adlarla iki değer eklenirse, önerilen bir uygulama olmayan özel durum oluşturmaz. Ancak, tam olarak aynı ada sahip iki değerin eklenmesi, değerinin SerializationException atmasına neden olur. Örneğin:

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