SerializationInfo.AddValue Метод

Определение

Пространство имен:

System.Runtime.Serialization

Сборки:

netstandard.dll, System.Runtime.dll

Добавляет значение в SerializationInfoобъект .

Перегрузки

Имя	Описание
AddValue(String, Object, Type)	Добавляет значение в SerializationInfo хранилище, value с name которым связано и сериализуется как являющееся Typetype.
AddValue(String, UInt64)	Добавляет 64-разрядное целое число без знака в SerializationInfo хранилище.
AddValue(String, UInt32)	Добавляет в хранилище 32-разрядное целое число SerializationInfo без знака.
AddValue(String, UInt16)	Добавляет в хранилище 16-разрядное целое число SerializationInfo без знака.
AddValue(String, Single)	Добавляет значение с плавающей запятой с одной точностью в SerializationInfo хранилище.
AddValue(String, SByte)	Добавляет 8-разрядное целое число со знаком в SerializationInfo хранилище.
AddValue(String, Object)	Добавляет указанный объект в SerializationInfo хранилище, где он связан с указанным именем.
AddValue(String, Int64)	Добавляет 64-разрядное целое число со знаком в SerializationInfo хранилище.
AddValue(String, Int32)	Добавляет 32-разрядное целое число со знаком в SerializationInfo хранилище.
AddValue(String, Int16)	Добавляет 16-разрядное целое число со знаком в SerializationInfo хранилище.
AddValue(String, Double)	Добавляет значение с плавающей запятой двойной точности в SerializationInfo хранилище.
AddValue(String, Decimal)	Добавляет десятичное значение в SerializationInfo хранилище.
AddValue(String, DateTime)	DateTime Добавляет значение в SerializationInfo хранилище.
AddValue(String, Char)	Добавляет значение символа Юникода в SerializationInfo хранилище.
AddValue(String, Byte)	Добавляет в хранилище 8-разрядное целое число SerializationInfo без знака.
AddValue(String, Boolean)	Добавляет логическое значение в SerializationInfo хранилище.

AddValue(String, Object, Type)

Исходный код:

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);

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.

Комментарии

Назначенный тип всегда является типом объекта или одним из его родителей.

Если два значения добавляются с именами, которые отличаются только по регистру, исключение не будет создано, что не рекомендуется. Однако добавление двух значений с одинаковым именем приведет SerializationException к возникновению ошибки.

AddValue(String, UInt64)

Исходный код:

SerializationInfo.cs

Важно!

Этот API несовместим с CLS.

Добавляет 64-разрядное целое число без знака в SerializationInfo хранилище.

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.

Комментарии

Если два значения добавляются с именами, которые отличаются только по регистру, исключение не будет создано, что не рекомендуется. Однако добавление двух значений с одинаковым именем приведет SerializationException к возникновению ошибки.

AddValue(String, UInt32)

Исходный код:

SerializationInfo.cs

Важно!

Этот API несовместим с CLS.

Добавляет в хранилище 32-разрядное целое число SerializationInfo без знака.

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.

Комментарии

Если два значения добавляются с именами, которые отличаются только по регистру, исключение не будет создано, что не рекомендуется. Однако добавление двух значений с одинаковым именем приведет SerializationException к возникновению ошибки.

AddValue(String, UInt16)

Исходный код:

SerializationInfo.cs

Важно!

Этот API несовместим с CLS.

Добавляет в хранилище 16-разрядное целое число SerializationInfo без знака.

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.

Комментарии

Если два значения добавляются с именами, которые отличаются только по регистру, исключение не будет создано, что не рекомендуется. Однако добавление двух значений с одинаковым именем приведет SerializationException к возникновению ошибки.

AddValue(String, Single)

Исходный код:

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.

Комментарии

Если два значения добавляются с именами, которые отличаются только по регистру, исключение не будет создано, что не рекомендуется. Однако добавление двух значений с одинаковым именем приведет SerializationException к возникновению ошибки.

AddValue(String, SByte)

Исходный код:

SerializationInfo.cs

Важно!

Этот API несовместим с CLS.

Добавляет 8-разрядное целое число со знаком в SerializationInfo хранилище.

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.

Комментарии

Если два значения добавляются с именами, которые отличаются только по регистру, исключение не будет создано, что не рекомендуется. Однако добавление двух значений с одинаковым именем приведет SerializationException к возникновению ошибки.

AddValue(String, Object)

Исходный код:

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

Значение, которое необходимо сериализовать. Все дочерние элементы этого объекта будут сериализованы автоматически.

Исключения

ArgumentNullException

name равно null.

SerializationException

Значение уже связано с name.

Комментарии

Объект, содержащийся в параметре value , сериализуется как тип, возвращаемый value.

Если два значения добавляются с именами, которые отличаются только по регистру, исключение не будет создано, что не рекомендуется. Однако добавление двух значений с одинаковым именем приведет SerializationException к возникновению ошибки.

AddValue(String, Int64)

Исходный код:

SerializationInfo.cs

Добавляет 64-разрядное целое число со знаком в SerializationInfo хранилище.

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.

Комментарии

Если два значения добавляются с именами, которые отличаются только по регистру, исключение не будет создано, что не рекомендуется. Однако добавление двух значений с одинаковым именем приведет SerializationException к возникновению ошибки.

AddValue(String, Int32)

Исходный код:

SerializationInfo.cs

Добавляет 32-разрядное целое число со знаком в SerializationInfo хранилище.

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.

Комментарии

Если два значения добавляются с именами, которые отличаются только по регистру, исключение не будет создано, что не рекомендуется. Однако добавление двух значений с одинаковым именем приведет SerializationException к возникновению ошибки.

AddValue(String, Int16)

Исходный код:

SerializationInfo.cs

Добавляет 16-разрядное целое число со знаком в SerializationInfo хранилище.

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.

Комментарии

Если два значения добавляются с именами, которые отличаются только по регистру, исключение не будет создано, что не рекомендуется. Однако добавление двух значений с одинаковым именем приведет SerializationException к возникновению ошибки.

AddValue(String, Double)

Исходный код:

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.

Комментарии

Если два значения добавляются с именами, которые отличаются только по регистру, исключение не будет создано, что не рекомендуется. Однако добавление двух значений с одинаковым именем приведет SerializationException к возникновению ошибки.

AddValue(String, Decimal)

Исходный код:

SerializationInfo.cs

Добавляет десятичное значение в SerializationInfo хранилище.

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

Десятичное значение для сериализации.

Исключения

ArgumentNullException

Если name параметр имеет значение null.

SerializationException

Если значение уже связано с name.

Комментарии

Если два значения добавляются с именами, которые отличаются только по регистру, исключение не будет создано, что не рекомендуется. Однако добавление двух значений с одинаковым именем приведет SerializationException к возникновению ошибки.

AddValue(String, DateTime)

Исходный код:

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.

Комментарии

Если два значения добавляются с именами, которые отличаются только по регистру, исключение не будет создано, что не рекомендуется. Однако добавление двух значений с одинаковым именем приведет SerializationException к возникновению ошибки.

AddValue(String, Char)

Исходный код:

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

Значение символа для сериализации.

Исключения

ArgumentNullException

Параметр name имеет значение null.

SerializationException

Значение уже связано с name.

Комментарии

Если два значения добавляются с именами, которые отличаются только по регистру, исключение не будет создано, что не рекомендуется. Однако добавление двух значений с одинаковым именем приведет SerializationException к возникновению ошибки.

AddValue(String, Byte)

Исходный код:

SerializationInfo.cs

Добавляет в хранилище 8-разрядное целое число SerializationInfo без знака.

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.

Комментарии

Если два значения добавляются с именами, которые отличаются только по регистру, исключение не будет создано, что не рекомендуется. Однако добавление двух значений с одинаковым именем приведет SerializationException к возникновению ошибки.

AddValue(String, Boolean)

Исходный код:

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.

Комментарии

Если два значения добавляются с именами, которые отличаются только по регистру, исключение не будет создано, что не рекомендуется. Однако добавление двух значений с одинаковым именем приведет 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