SerializationInfo.AddValue 메서드

정의

네임스페이스:

System.Runtime.Serialization

어셈블리:

System.Runtime.dll

SerializationInfo에 값을 추가합니다.

오버로드

AddValue(String, Object, Type)	SerializationInfo 저장소에 값을 추가합니다. 여기서 value는 name과 연결되고 Typetype으로 serialize됩니다.
AddValue(String, UInt64)	SerializationInfo 저장소에 부호 없는 64비트 정수 값을 추가합니다.
AddValue(String, UInt32)	SerializationInfo 저장소에 부호 없는 32비트 정수 값을 추가합니다.
AddValue(String, UInt16)	SerializationInfo 저장소에 부호 없는 16비트 정수 값을 추가합니다.
AddValue(String, Single)	SerializationInfo 저장소에 단정밀도 부동 소수점 값을 추가합니다.
AddValue(String, SByte)	SerializationInfo 저장소에 부호 있는 8비트 정수 값을 추가합니다.
AddValue(String, Object)	SerializationInfo 저장소에 지정된 개체를 추가합니다. 여기서 해당 개체는 지정된 이름과 연결됩니다.
AddValue(String, Int64)	SerializationInfo 저장소에 부호 있는 64비트 정수 값을 추가합니다.
AddValue(String, Int32)	SerializationInfo 저장소에 부호 있는 32비트 정수 값을 추가합니다.
AddValue(String, Int16)	SerializationInfo 저장소에 부호 있는 16비트 정수 값을 추가합니다.
AddValue(String, Double)	SerializationInfo 저장소에 배정밀도 부동 소수점 값을 추가합니다.
AddValue(String, Decimal)	SerializationInfo 저장소에 10진수 값을 추가합니다.
AddValue(String, DateTime)	DateTime 저장소에 SerializationInfo 값을 추가합니다.
AddValue(String, Char)	SerializationInfo 저장소에 유니코드 문자 값을 추가합니다.
AddValue(String, Byte)	SerializationInfo 저장소에 부호 없는 8비트 정수 값을 추가합니다.
AddValue(String, Boolean)	SerializationInfo 저장소에 부울 값을 추가합니다.

AddValue(String, Object, Type)

Source:

SerializationInfo.cs

SerializationInfo 저장소에 값을 추가합니다. 여기서 value는 name과 연결되고 Typetype으로 serialize됩니다.

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

serialize될 값입니다. 이 개체의 자식은 자동으로 serialize됩니다.

type

Type

현재 개체와 관련된 Type입니다. 이 매개 변수는 항상 개체 자체의 형식 또는 기본 클래스 중 하나의 형식이어야 합니다.

예외

ArgumentNullException

name 또는 type이 null인 경우

SerializationException

값이 이미 name과 관련되어 있는 경우

설명

할당된 형식은 항상 개체의 형식이거나 부모 중 하나입니다.

대/소문자만 다른 이름으로 두 값을 추가하면 예외가 throw되지 않으므로 권장되지 않습니다. 그러나 이름이 정확히 같은 두 값을 추가하면 이 SerializationException throw됩니다.

AddValue(String, UInt64)

Source:

SerializationInfo.cs

중요

이 API는 CLS 규격이 아닙니다.

SerializationInfo 저장소에 부호 없는 64비트 정수 값을 추가합니다.

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과 관련되어 있는 경우

설명

대/소문자만 다른 이름으로 두 값을 추가하면 예외가 throw되지 않으므로 권장되지 않습니다. 그러나 이름이 정확히 같은 두 값을 추가하면 이 SerializationException throw됩니다.

AddValue(String, UInt32)

Source:

SerializationInfo.cs

중요

이 API는 CLS 규격이 아닙니다.

SerializationInfo 저장소에 부호 없는 32비트 정수 값을 추가합니다.

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

serialize할 UInt32 값입니다.

특성

CLSCompliantAttribute

예외

ArgumentNullException

name 매개 변수가 null인 경우

SerializationException

값이 이미 name과 관련되어 있는 경우

설명

대/소문자만 다른 이름으로 두 값을 추가하면 예외가 throw되지 않으므로 권장되지 않습니다. 그러나 이름이 정확히 같은 두 값을 추가하면 이 SerializationException throw됩니다.

AddValue(String, UInt16)

Source:

SerializationInfo.cs

중요

이 API는 CLS 규격이 아닙니다.

SerializationInfo 저장소에 부호 없는 16비트 정수 값을 추가합니다.

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

serialize할 UInt16 값입니다.

특성

CLSCompliantAttribute

예외

ArgumentNullException

name 매개 변수가 null인 경우

SerializationException

값이 이미 name과 관련되어 있는 경우

설명

대/소문자만 다른 이름으로 두 값을 추가하면 예외가 throw되지 않으므로 권장되지 않습니다. 그러나 이름이 정확히 같은 두 값을 추가하면 이 SerializationException throw됩니다.

AddValue(String, Single)

Source:

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

serialize할 single 값입니다.

예외

ArgumentNullException

name 매개 변수가 null인 경우

SerializationException

값이 이미 name과 관련되어 있는 경우

설명

대/소문자만 다른 이름으로 두 값을 추가하면 예외가 throw되지 않으므로 권장되지 않습니다. 그러나 이름이 정확히 같은 두 값을 추가하면 이 SerializationException throw됩니다.

AddValue(String, SByte)

Source:

SerializationInfo.cs

중요

이 API는 CLS 규격이 아닙니다.

SerializationInfo 저장소에 부호 있는 8비트 정수 값을 추가합니다.

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

serialize할 Sbyte 값입니다.

특성

CLSCompliantAttribute

예외

ArgumentNullException

name 매개 변수가 null인 경우

SerializationException

값이 이미 name과 관련되어 있는 경우

설명

대/소문자만 다른 이름으로 두 값을 추가하면 예외가 throw되지 않으므로 권장되지 않습니다. 그러나 이름이 정확히 같은 두 값을 추가하면 이 SerializationException throw됩니다.

AddValue(String, Object)

Source:

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

serialize될 값입니다. 이 개체의 자식은 자동으로 serialize됩니다.

예외

ArgumentNullException

name이(가) null인 경우

SerializationException

값이 이미 name과 관련되어 있는 경우

설명

매개 변수에 포함된 개체는 에서 value 반환 value된 형식으로 serialize됩니다.

대/소문자만 다른 이름으로 두 값을 추가하면 예외가 throw되지 않으므로 권장되지 않습니다. 그러나 이름이 정확히 같은 두 값을 추가하면 이 SerializationException throw됩니다.

AddValue(String, Int64)

Source:

SerializationInfo.cs

SerializationInfo 저장소에 부호 있는 64비트 정수 값을 추가합니다.

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

serialize할 Int64 값입니다.

예외

ArgumentNullException

name 매개 변수가 null인 경우

SerializationException

값이 이미 name과 관련되어 있는 경우

설명

대/소문자만 다른 이름으로 두 값을 추가하면 예외가 throw되지 않으므로 권장되지 않습니다. 그러나 이름이 정확히 같은 두 값을 추가하면 이 SerializationException throw됩니다.

AddValue(String, Int32)

Source:

SerializationInfo.cs

SerializationInfo 저장소에 부호 있는 32비트 정수 값을 추가합니다.

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

serialize할 Int32 값입니다.

예외

ArgumentNullException

name 매개 변수가 null인 경우

SerializationException

값이 이미 name과 관련되어 있는 경우

설명

대/소문자만 다른 이름으로 두 값을 추가하는 경우 예외가 throw되지 않으므로 권장되는 방법은 아닙니다. 그러나 이름이 정확히 같은 두 값을 추가하면 이 SerializationException throw됩니다.

AddValue(String, Int16)

Source:

SerializationInfo.cs

SerializationInfo 저장소에 부호 있는 16비트 정수 값을 추가합니다.

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

serialize할 Int16 값입니다.

예외

ArgumentNullException

name 매개 변수가 null인 경우

SerializationException

값이 이미 name과 관련되어 있는 경우

설명

대/소문자만 다른 이름으로 두 값을 추가하는 경우 예외가 throw되지 않으므로 권장되는 방법은 아닙니다. 그러나 이름이 정확히 같은 두 값을 추가하면 이 SerializationException throw됩니다.

AddValue(String, Double)

Source:

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

serialize할 double 값입니다.

예외

ArgumentNullException

name 매개 변수가 null인 경우

SerializationException

값이 이미 name과 관련되어 있는 경우

설명

대/소문자만 다른 이름으로 두 값을 추가하는 경우 예외가 throw되지 않으므로 권장되는 방법은 아닙니다. 그러나 이름이 정확히 같은 두 값을 추가하면 이 SerializationException throw됩니다.

AddValue(String, Decimal)

Source:

SerializationInfo.cs

SerializationInfo 저장소에 10진수 값을 추가합니다.

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

serialize할 10진수 값입니다.

예외

ArgumentNullException

name 매개 변수가 null인 경우

SerializationException

값이 이미 name과 관련되어 있는 경우

설명

대/소문자만 다른 이름으로 두 값을 추가하는 경우 예외가 throw되지 않으므로 권장되는 방법은 아닙니다. 그러나 이름이 정확히 같은 두 값을 추가하면 이 SerializationException throw됩니다.

AddValue(String, DateTime)

Source:

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

serialize할 DateTime 값입니다.

예외

ArgumentNullException

name 매개 변수가 null인 경우

SerializationException

값이 이미 name과 관련되어 있는 경우

설명

대/소문자만 다른 이름으로 두 값을 추가하는 경우 예외가 throw되지 않으므로 권장되는 방법은 아닙니다. 그러나 이름이 정확히 같은 두 값을 추가하면 이 SerializationException throw됩니다.

AddValue(String, Char)

Source:

SerializationInfo.cs

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

serialize할 문자 값입니다.

예외

ArgumentNullException

name 매개 변수가 null인 경우

SerializationException

값이 이미 name과 관련되어 있는 경우

설명

대/소문자만 다른 이름으로 두 값을 추가하는 경우 예외가 throw되지 않으므로 권장되는 방법은 아닙니다. 그러나 이름이 정확히 같은 두 값을 추가하면 이 SerializationException throw됩니다.

AddValue(String, Byte)

Source:

SerializationInfo.cs

SerializationInfo 저장소에 부호 없는 8비트 정수 값을 추가합니다.

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

serialize할 바이트 값입니다.

예외

ArgumentNullException

name 매개 변수가 null인 경우

SerializationException

값이 이미 name과 관련되어 있는 경우

설명

대/소문자만 다른 이름으로 두 값을 추가하는 경우 예외가 throw되지 않으므로 권장되는 방법은 아닙니다. 그러나 이름이 정확히 같은 두 값을 추가하면 이 SerializationException throw됩니다.

AddValue(String, Boolean)

Source:

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

serialize할 Boolean 값입니다.

예외

ArgumentNullException

name 매개 변수가 null인 경우

SerializationException

값이 이미 name과 관련되어 있는 경우

설명

대/소문자만 다른 이름으로 두 값을 추가하는 경우 예외가 throw되지 않으므로 권장되는 방법은 아닙니다. 그러나 이름이 정확히 같은 두 값을 추가하면 이 SerializationException throw됩니다. 예를 들면 다음과 같습니다.

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