SerializationInfo.AddValue メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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);public void AddValue (string name, object value, Type type);member this.AddValue : string * obj * Type -> unitPublic Sub AddValue (name As String, value As Object, type As Type)パラメーター
- name
- String
後から逆シリアル化できるように、値に関連付けておく名前。
- value
- Object
シリアル化される値。 このオブジェクトの子は、自動的にシリアル化されます。
例外
name または type が null の場合。
値が既に 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 -> unitPublic 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 -> unitPublic Sub AddValue (name As String, value As UInteger)パラメーター
- name
- String
後から逆シリアル化できるように、値に関連付けておく名前。
- 属性
例外
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 -> unitPublic Sub AddValue (name As String, value As UShort)パラメーター
- name
- String
後から逆シリアル化できるように、値に関連付けておく名前。
- 属性
例外
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 -> unitPublic 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 -> unitPublic 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 -> unitPublic Sub AddValue (name As String, value As Object)パラメーター
- name
- String
後から逆シリアル化できるように、値に関連付けておく名前。
- value
- Object
シリアル化される値。 このオブジェクトの子は、自動的にシリアル化されます。
例外
name が nullです。
値が既に 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 -> unitPublic 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 -> unitPublic Sub AddValue (name As String, value As Integer)パラメーター
- name
- String
後から逆シリアル化できるように、値に関連付けておく名前。
例外
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 -> unitPublic Sub AddValue (name As String, value As Short)パラメーター
- name
- String
後から逆シリアル化できるように、値に関連付けておく名前。
例外
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 -> unitPublic 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 -> unitPublic 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 -> unitPublic Sub AddValue (name As String, value As DateTime)パラメーター
- name
- String
後から逆シリアル化できるように、値に関連付けておく名前。
例外
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 -> unitPublic 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 -> unitPublic 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 -> unitPublic 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
適用対象
.NET