SerializationInfo.AddValue メソッド

定義

SerializationInfo に値を追加します。

オーバーロード

AddValue(String, Object, Type)

SerializationInfo ストアに値を追加します。ここで、valuename に関連付けられ、Typetype の値としてシリアル化されます。

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 ストアに値を追加します。ここで、valuename に関連付けられ、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 つの型にする必要があります。

例外

name または typenull の場合。

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

注釈

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

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

シリアル化する値。

属性

例外

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

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

注釈

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

適用対象

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 値。

属性

例外

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

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

注釈

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

適用対象

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 値。

属性

例外

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

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

注釈

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

適用対象

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

シリアル化する単精度浮動小数点数型の値。

例外

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

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

注釈

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

適用対象

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 値。

属性

例外

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

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

注釈

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

適用対象

AddValue(String, Object)

指定したオブジェクトを 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

シリアル化される値。 このオブジェクトの子は、自動的にシリアル化されます。

例外

namenullです。

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

注釈

パラメーターに value 含まれるオブジェクトは、 によって value返される型としてシリアル化されます。

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

適用対象

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 型の値。

例外

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

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

注釈

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

適用対象

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 値。

例外

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

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

注釈

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

適用対象

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 値。

例外

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

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

注釈

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

適用対象

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

シリアル化する倍精度浮動小数点数型の値。

例外

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

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

注釈

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

適用対象

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 進値。

例外

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

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

注釈

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

適用対象

AddValue(String, DateTime)

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 値。

例外

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

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

注釈

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

適用対象

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

シリアル化する文字値。

例外

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

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

注釈

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

適用対象

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

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

例外

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

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

注釈

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

適用対象

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

シリアル化するブール値。

例外

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

値が既に 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  

適用対象