SerializationInfo.AddValue メソッド

定義

名前空間:: System.Runtime.Serialization

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

SerializationInfoに値を追加します。

オーバーロード

名前	説明
AddValue(String, Object, Type)	SerializationInfo ストアに値を追加します。`value`は`name`に関連付け、Type`type`としてシリアル化されます。
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)	SerializationInfo ストアにDateTime値を追加します。
AddValue(String, Char)	SerializationInfo ストアに Unicode 文字値を追加します。
AddValue(String, Byte)	SerializationInfo ストアに 8 ビット符号なし整数値を追加します。
AddValue(String, Boolean)	SerializationInfo ストアにブール値を追加します。

AddValue(String, Object, Type)

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に関連付けられています。

注釈

割り当てられた型は、常にオブジェクトの型、またはその親のいずれかです。

大文字と小文字のみが異なる名前の 2 つの値を追加した場合、例外はスローされません。これは推奨される方法ではありません。ただし、まったく同じ名前の 2 つの値を追加すると、 SerializationException がスローされます。

適用対象

AddValue(String, UInt64)

重要

この 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に関連付けられています。

注釈

適用対象

AddValue(String, UInt32)

重要

この 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

シリアル化する UInt32 値。

属性: CLSCompliantAttribute

例外

ArgumentNullException

name パラメーターはnull。

SerializationException

値は既に nameに関連付けられています。

注釈

適用対象

AddValue(String, UInt16)

重要

この 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

シリアル化する UInt16 値。

属性: CLSCompliantAttribute

例外

ArgumentNullException

name パラメーターはnull。

SerializationException

値は既に nameに関連付けられています。

注釈

適用対象

AddValue(String, Single)

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

シリアル化する 1 つの値。

例外

ArgumentNullException

name パラメーターはnull。

SerializationException

値は既に nameに関連付けられています。

注釈

適用対象

AddValue(String, SByte)

重要

この 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

シリアル化する Sbyte 値。

属性: CLSCompliantAttribute

例外

ArgumentNullException

name パラメーターはnull。

SerializationException

値は既に nameに関連付けられています。

注釈

適用対象

AddValue(String, Object)

指定したオブジェクトを、指定した名前に関連付けられている 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によって返される型としてシリアル化されます。

適用対象

AddValue(String, Int64)

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

シリアル化する Int64 値。

例外

ArgumentNullException

name パラメーターはnull。

SerializationException

値は既に nameに関連付けられています。

注釈

適用対象

AddValue(String, Int32)

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

シリアル化する Int32 値。

例外

ArgumentNullException

name パラメーターはnull。

SerializationException

値は既に nameに関連付けられています。

注釈

適用対象

AddValue(String, Int16)

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

シリアル化する Int16 値。

例外

ArgumentNullException

name パラメーターはnull。

SerializationException

値は既に nameに関連付けられています。

注釈

適用対象

AddValue(String, Double)

倍精度浮動小数点値を 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

シリアル化する double 値。

例外

ArgumentNullException

name パラメーターはnull。

SerializationException

値は既に nameに関連付けられています。

注釈

適用対象

AddValue(String, Decimal)

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

シリアル化する 10 進値。

例外

ArgumentNullException

name パラメーターがnullされている場合。

SerializationException

値が既に nameに関連付けられている場合。

注釈

適用対象

AddValue(String, DateTime)

SerializationInfo ストアにDateTime値を追加します。

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に関連付けられています。

注釈

適用対象

AddValue(String, Char)

SerializationInfo ストアに Unicode 文字値を追加します。

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に関連付けられています。

注釈

適用対象

AddValue(String, Byte)

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

シリアル化するバイト値。

例外

ArgumentNullException

name パラメーターはnull。

SerializationException

値は既に nameに関連付けられています。

注釈

適用対象

AddValue(String, Boolean)

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に関連付けられています。

注釈

大文字と小文字のみが異なる名前の 2 つの値を追加した場合、例外はスローされません。これは推奨される方法ではありません。ただし、まったく同じ名前の 2 つの値を追加すると、 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

適用対象

フィードバック

このページはお役に立ちましたか?