SerializationInfo.AddValue メソッド

リファレンス

定義

名前空間:: System.Runtime.Serialization

アセンブリ:: System.Runtime.dll

アセンブリ:: System.Runtime.Serialization.Formatters.dll

アセンブリ:: 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)	DateTime ストアに SerializationInfo 値を追加します。
AddValue(String, Char)	SerializationInfo ストアに Unicode 文字値を追加します。
AddValue(String, Byte)	SerializationInfo ストアに 8 ビット符号なし整数値を追加します。
AddValue(String, Boolean)	SerializationInfo ストアにブール値を追加します。

AddValue(String, Object, Type)

ソース:: SerializationInfo.cs

ソース:: SerializationInfo.cs

ソース:: 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);

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。このパラメーターは、常にオブジェクト自体の型、またはオブジェクトの基本クラスの 1 つの型にする必要があります。

例外

ArgumentNullException

name または type が null の場合。

SerializationException

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

注釈

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

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

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

AddValue(String, UInt64)

ソース:: SerializationInfo.cs

ソース:: SerializationInfo.cs

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

注釈

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

AddValue(String, UInt32)

ソース:: SerializationInfo.cs

ソース:: SerializationInfo.cs

ソース:: 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

シリアル化する UInt32 値。

属性: CLSCompliantAttribute

例外

ArgumentNullException

name パラメーターが null です。

SerializationException

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

注釈

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

AddValue(String, UInt16)

ソース:: SerializationInfo.cs

ソース:: SerializationInfo.cs

ソース:: 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

シリアル化する UInt16 値。

属性: CLSCompliantAttribute

例外

ArgumentNullException

name パラメーターが null です。

SerializationException

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

注釈

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

AddValue(String, Single)

ソース:: SerializationInfo.cs

ソース:: SerializationInfo.cs

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

注釈

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

AddValue(String, SByte)

ソース:: SerializationInfo.cs

ソース:: SerializationInfo.cs

ソース:: 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

シリアル化する Sbyte 値。

属性: CLSCompliantAttribute

例外

ArgumentNullException

name パラメーターが null です。

SerializationException

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

注釈

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

AddValue(String, Object)

ソース:: SerializationInfo.cs

ソース:: SerializationInfo.cs

ソース:: SerializationInfo.cs

指定したオブジェクトを SerializationInfo ストアに追加します。ここで、そのオブジェクトが指定した名前に関連付けられます。

public:
 void AddValue(System::String ^ name, System::Object ^ value);

public void AddValue (string name, 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返される型としてシリアル化されます。

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

AddValue(String, Int64)

ソース:: SerializationInfo.cs

ソース:: SerializationInfo.cs

ソース:: 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

シリアル化する Int64 型の値。

例外

ArgumentNullException

name パラメーターが null です。

SerializationException

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

注釈

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

AddValue(String, Int32)

ソース:: SerializationInfo.cs

ソース:: SerializationInfo.cs

ソース:: 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

シリアル化する Int32 値。

例外

ArgumentNullException

name パラメーターが null です。

SerializationException

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

注釈

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

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

AddValue(String, Int16)

ソース:: SerializationInfo.cs

ソース:: SerializationInfo.cs

ソース:: 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

シリアル化する Int16 値。

例外

ArgumentNullException

name パラメーターが null です。

SerializationException

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

注釈

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

AddValue(String, Double)

ソース:: SerializationInfo.cs

ソース:: SerializationInfo.cs

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

注釈

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

AddValue(String, Decimal)

ソース:: SerializationInfo.cs

ソース:: SerializationInfo.cs

ソース:: 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

シリアル化する 10 進値。

例外

ArgumentNullException

name パラメーターが null の場合。

SerializationException

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

注釈

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

AddValue(String, DateTime)

ソース:: SerializationInfo.cs

ソース:: SerializationInfo.cs

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

注釈

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

AddValue(String, Char)

ソース:: SerializationInfo.cs

ソース:: SerializationInfo.cs

ソース:: SerializationInfo.cs

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

注釈

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

AddValue(String, Byte)

ソース:: SerializationInfo.cs

ソース:: SerializationInfo.cs

ソース:: 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

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

例外

ArgumentNullException

name パラメーターが null です。

SerializationException

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

注釈

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

AddValue(String, Boolean)

ソース:: SerializationInfo.cs

ソース:: SerializationInfo.cs

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

注釈

大文字と小文字のみが異なる名前を持つ 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

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

次の方法で共有

SerializationInfo.AddValue メソッド

定義

オーバーロード

AddValue(String, Object, Type)

パラメーター

例外

注釈

適用対象

AddValue(String, UInt64)

パラメーター

例外

注釈

適用対象

AddValue(String, UInt32)

パラメーター

例外

注釈

適用対象

AddValue(String, UInt16)

パラメーター

例外

注釈

適用対象

AddValue(String, Single)

パラメーター

例外

注釈

適用対象

AddValue(String, SByte)

パラメーター

例外

注釈

適用対象

AddValue(String, Object)

パラメーター

例外

注釈

適用対象

AddValue(String, Int64)

パラメーター

例外

注釈

適用対象

AddValue(String, Int32)

パラメーター

例外

注釈

適用対象

AddValue(String, Int16)

パラメーター

例外

注釈

適用対象

AddValue(String, Double)

パラメーター

例外

注釈

適用対象

AddValue(String, Decimal)

パラメーター

例外

注釈

適用対象

AddValue(String, DateTime)

パラメーター

例外

注釈

適用対象

AddValue(String, Char)

パラメーター

例外

注釈

適用対象

AddValue(String, Byte)

パラメーター

例外

注釈

適用対象

AddValue(String, Boolean)