SerializationInfo.AddValue 方法

定義

命名空間:

System.Runtime.Serialization

組件:

netstandard.dll, System.Runtime.dll

會為 SerializationInfo。

多載

名稱	Description
AddValue(String, Object, Type)	在儲存中加入一個值SerializationInfo，其中value與 相關聯name，且序列化為 。Typetype
AddValue(String, UInt64)	在儲存中加入一個 64 位元的無符號整數值 SerializationInfo 。
AddValue(String, UInt32)	在儲存中加入一個 32 位元的無符號整數值 SerializationInfo 。
AddValue(String, UInt16)	在儲存中加入一個 16 位元的無符號整數值 SerializationInfo 。
AddValue(String, Single)	在儲存中加入一個單精度浮點數值 SerializationInfo 。
AddValue(String, SByte)	在儲存中加入一個 8 位元有符號整數值 SerializationInfo 。
AddValue(String, Object)	將指定的物件加入儲存， SerializationInfo 並與指定名稱相關聯。
AddValue(String, Int64)	在儲存中加入一個 64 位元有符號的整數值 SerializationInfo 。
AddValue(String, Int32)	在儲存中加入一個 32 位元有符號的整數值 SerializationInfo 。
AddValue(String, Int16)	在儲存中加入一個 16 位元有符號的整數值 SerializationInfo 。
AddValue(String, Double)	在儲存中加入一個雙精度浮點數值 SerializationInfo 。
AddValue(String, Decimal)	在商店中加入一個小數值 SerializationInfo 。
AddValue(String, DateTime)	為商店增添 DateTime 價值 SerializationInfo 。
AddValue(String, Char)	在儲存庫中新增一個 Unicode 字元值 SerializationInfo 。
AddValue(String, Byte)	在儲存中加入一個 8 位元無符號整數值 SerializationInfo 。
AddValue(String, Boolean)	會為 SerializationInfo 商店增加一個布林值。

AddValue(String, Object, Type)

來源:

SerializationInfo.cs

在儲存中加入一個值SerializationInfo，其中value與 相關聯name，且序列化為 。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)

參數

name

String

名稱要與該值關聯，以便之後可以反序列化。

value

Object

要序列化的數值。 此物件的任何子節點都會自動被序列化。

type

Type

Type與當前物件關聯。 此參數必須始終是物件本身或其基底類別的型別。

例外狀況

ArgumentNullException

若 name 或 type 為 null。

SerializationException

一個值已經與 相關聯 name。

備註

指派的型別總是物件的型別，或其父型之一。

若新增兩個名稱僅因格而異的值，則不會拋出例外，這並非建議做法。 然而，若加上兩個名稱完全相同的值，會導致拋棄。SerializationException

AddValue(String, UInt64)

來源:

SerializationInfo.cs

重要

此 API 不符合 CLS 規範。

在儲存中加入一個 64 位元的無符號整數值 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)

參數

name

String

名稱要與該值關聯，以便之後可以反序列化。

value

UInt64

序列化的價值。

屬性

CLSCompliantAttribute

例外狀況

ArgumentNullException

參數 name 為 null。

SerializationException

一個值已經與 相關聯 name。

備註

若新增兩個名稱僅因格而異的值，則不會拋出例外，這並非建議做法。 然而，若加上兩個名稱完全相同的值，會導致拋棄。SerializationException

AddValue(String, UInt32)

來源:

SerializationInfo.cs

重要

此 API 不符合 CLS 規範。

在儲存中加入一個 32 位元的無符號整數值 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)

參數

name

String

名稱要與該值關聯，以便之後可以反序列化。

value

UInt32

序列化的 UInt32 價值。

屬性

CLSCompliantAttribute

例外狀況

ArgumentNullException

參數 name 為 null。

SerializationException

一個值已經與 相關聯 name。

備註

若新增兩個名稱僅因格而異的值，則不會拋出例外，這並非建議做法。 然而，若加上兩個名稱完全相同的值，會導致拋棄。SerializationException

AddValue(String, UInt16)

來源:

SerializationInfo.cs

重要

此 API 不符合 CLS 規範。

在儲存中加入一個 16 位元的無符號整數值 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)

參數

name

String

名稱要與該值關聯，以便之後可以反序列化。

value

UInt16

序列化的 UInt16 價值。

屬性

CLSCompliantAttribute

例外狀況

ArgumentNullException

參數 name 為 null。

SerializationException

一個值已經與 相關聯 name。

備註

若新增兩個名稱僅因格而異的值，則不會拋出例外，這並非建議做法。 然而，若加上兩個名稱完全相同的值，會導致拋棄。SerializationException

AddValue(String, Single)

來源:

SerializationInfo.cs

在儲存中加入一個單精度浮點數值 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)

參數

name

String

名稱要與該值關聯，以便之後可以反序列化。

value

Single

唯一要序列化的值。

例外狀況

ArgumentNullException

參數 name 為 null。

SerializationException

一個值已經與 相關聯 name。

備註

若新增兩個名稱僅因格而異的值，則不會拋出例外，這並非建議做法。 然而，若加上兩個名稱完全相同的值，會導致拋棄。SerializationException

AddValue(String, SByte)

來源:

SerializationInfo.cs

重要

此 API 不符合 CLS 規範。

在儲存中加入一個 8 位元有符號整數值 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)

參數

name

String

名稱要與該值關聯，以便之後可以反序列化。

value

SByte

序列化的 Sbyte 價值。

屬性

CLSCompliantAttribute

例外狀況

ArgumentNullException

參數 name 為 null。

SerializationException

一個值已經與 相關聯 name。

備註

若新增兩個名稱僅因格而異的值，則不會拋出例外，這並非建議做法。 然而，若加上兩個名稱完全相同的值，會導致拋棄。SerializationException

AddValue(String, Object)

來源:

SerializationInfo.cs

將指定的物件加入儲存， SerializationInfo 並與指定名稱相關聯。

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)

參數

name

String

名稱要與該值關聯，以便之後可以反序列化。

value

Object

要序列化的數值。 此物件的任何子節點都會自動被序列化。

例外狀況

ArgumentNullException

name 是 null。

SerializationException

一個值已經與 相關聯 name。

備註

參數中包含的 value 物件會序列化為由 value返回的類型。

若新增兩個名稱僅因格而異的值，則不會拋出例外，這並非建議做法。 然而，若加上兩個名稱完全相同的值，會導致拋棄。SerializationException

AddValue(String, Int64)

來源:

SerializationInfo.cs

在儲存中加入一個 64 位元有符號的整數值 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)

參數

name

String

名稱要與該值關聯，以便之後可以反序列化。

value

Int64

Int64 值來串行。

例外狀況

ArgumentNullException

參數 name 為 null。

SerializationException

一個值已經與 相關聯 name。

備註

若新增兩個名稱僅因格而異的值，則不會拋出例外，這並非建議做法。 然而，若加上兩個名稱完全相同的值，會導致拋棄。SerializationException

AddValue(String, Int32)

來源:

SerializationInfo.cs

在儲存中加入一個 32 位元有符號的整數值 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)

參數

name

String

名稱要與該值關聯，以便之後可以反序列化。

value

Int32

序列化的 Int32 價值。

例外狀況

ArgumentNullException

參數 name 為 null。

SerializationException

一個值已經與 相關聯 name。

備註

若新增兩個名稱僅因格而異的值，則不會拋出例外，這並非建議做法。 然而，若加上兩個名稱完全相同的值，會導致拋棄。SerializationException

AddValue(String, Int16)

來源:

SerializationInfo.cs

在儲存中加入一個 16 位元有符號的整數值 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)

參數

name

String

名稱要與該值關聯，以便之後可以反序列化。

value

Int16

序列化的 Int16 價值。

例外狀況

ArgumentNullException

參數 name 為 null。

SerializationException

一個值已經與 相關聯 name。

備註

若新增兩個名稱僅因格而異的值，則不會拋出例外，這並非建議做法。 然而，若加上兩個名稱完全相同的值，會導致拋棄。SerializationException

AddValue(String, Double)

來源:

SerializationInfo.cs

在儲存中加入一個雙精度浮點數值 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)

參數

name

String

名稱要與該值關聯，以便之後可以反序列化。

value

Double

序列化的雙倍值。

例外狀況

ArgumentNullException

參數 name 為 null。

SerializationException

一個值已經與 相關聯 name。

備註

若新增兩個名稱僅因格而異的值，則不會拋出例外，這並非建議做法。 然而，若加上兩個名稱完全相同的值，會導致拋棄。SerializationException

AddValue(String, Decimal)

來源:

SerializationInfo.cs

在商店中加入一個小數值 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)

參數

name

String

名稱要與該值關聯，以便之後可以反序列化。

value

Decimal

用小數值來序列化。

例外狀況

ArgumentNullException

若參數 name 為 null。

SerializationException

如果某個值已經與 相關聯 name。

備註

若新增兩個名稱僅因格而異的值，則不會拋出例外，這並非建議做法。 然而，若加上兩個名稱完全相同的值，會導致拋棄。SerializationException

AddValue(String, DateTime)

來源:

SerializationInfo.cs

為商店增添 DateTime 價值 SerializationInfo 。

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)

參數

name

String

名稱要與該值關聯，以便之後可以反序列化。

value

DateTime

序列化的 DateTime 價值。

例外狀況

ArgumentNullException

參數 name 為 null。

SerializationException

一個值已經與 相關聯 name。

備註

若新增兩個名稱僅因格而異的值，則不會拋出例外，這並非建議做法。 然而，若加上兩個名稱完全相同的值，會導致拋棄。SerializationException

AddValue(String, Char)

來源:

SerializationInfo.cs

在儲存庫中新增一個 Unicode 字元值 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)

參數

name

String

名稱要與該值關聯，以便之後可以反序列化。

value

Char

連載的字元值。

例外狀況

ArgumentNullException

參數 name 為 null。

SerializationException

一個值已經與 相關聯 name。

備註

若新增兩個名稱僅因格而異的值，則不會拋出例外，這並非建議做法。 然而，若加上兩個名稱完全相同的值，會導致拋棄。SerializationException

AddValue(String, Byte)

來源:

SerializationInfo.cs

在儲存中加入一個 8 位元無符號整數值 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)

參數

name

String

名稱要與該值關聯，以便之後可以反序列化。

value

Byte

序列化的位元組值。

例外狀況

ArgumentNullException

參數 name 為 null。

SerializationException

一個值已經與 相關聯 name。

備註

若新增兩個名稱僅因格而異的值，則不會拋出例外，這並非建議做法。 然而，若加上兩個名稱完全相同的值，會導致拋棄。SerializationException

AddValue(String, Boolean)

來源:

SerializationInfo.cs

會為 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)

參數

name

String

名稱要與該值關聯，以便之後可以反序列化。

value

Boolean

序列化的布林值。

例外狀況

ArgumentNullException

參數 name 為 null。

SerializationException

一個值已經與 相關聯 name。

備註

若新增兩個名稱僅因格而異的值，則不會拋出例外，這並非建議做法。 然而，若加上兩個名稱完全相同的值，會導致拋棄。SerializationException 例如：

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