SerializationInfo.AddValue Метод

Ссылка

Определение

Пространство имен:: System.Runtime.Serialization

Сборка:: System.Runtime.dll

Сборка:: System.Runtime.Serialization.Formatters.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

AddValue(String, Object, Type)	Добавляет значение в хранилище SerializationInfo, где `value` связывается с `name` и сериализуется как Type`type`.
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.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 для связи с текущим объектом. Этот параметр всегда должен являться типом самого объекта или одним из его базовых классов.

Исключения

ArgumentNullException

Если name или type равны null.

SerializationException

С параметром name уже связано значение.

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

Применяется к

AddValue(String, UInt64)

Исходный код:: SerializationInfo.cs

Исходный код:: SerializationInfo.cs

Исходный код:: 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 уже связано значение.

Применяется к

AddValue(String, UInt32)

Исходный код:: SerializationInfo.cs

Исходный код:: SerializationInfo.cs

Исходный код:: 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 уже связано значение.

Применяется к

AddValue(String, UInt16)

Исходный код:: SerializationInfo.cs

Исходный код:: SerializationInfo.cs

Исходный код:: 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 уже связано значение.

Применяется к

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

Значение Single для сериализации.

Исключения

ArgumentNullException

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

SerializationException

С параметром name уже связано значение.

Применяется к

AddValue(String, SByte)

Исходный код:: SerializationInfo.cs

Исходный код:: SerializationInfo.cs

Исходный код:: 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 уже связано значение.

Применяется к

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 уже связано значение.

Применяется к

AddValue(String, Int64)

Исходный код:: SerializationInfo.cs

Исходный код:: SerializationInfo.cs

Исходный код:: 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 уже связано значение.

Применяется к

AddValue(String, Int32)

Исходный код:: SerializationInfo.cs

Исходный код:: SerializationInfo.cs

Исходный код:: 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 уже связано значение.

Применяется к

AddValue(String, Int16)

Исходный код:: SerializationInfo.cs

Исходный код:: SerializationInfo.cs

Исходный код:: 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 уже связано значение.

Применяется к

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 уже связано значение.

Применяется к

AddValue(String, Decimal)

Исходный код:: SerializationInfo.cs

Исходный код:: SerializationInfo.cs

Исходный код:: 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.

Применяется к

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 уже связано значение.

Применяется к

AddValue(String, Char)

Исходный код:: SerializationInfo.cs

Исходный код:: SerializationInfo.cs

Исходный код:: 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 уже связано значение.

Применяется к

AddValue(String, Byte)

Исходный код:: SerializationInfo.cs

Исходный код:: SerializationInfo.cs

Исходный код:: 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 уже связано значение.

Применяется к

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 уже связано значение.

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

Применяется к

Совместная работа с нами на GitHub

Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.

Отзыв о .NET

.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв:

Открыть проблему с документацией Отзыв о продукте

Поделиться через

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)