SerializationInfo.AddValue Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет значение в SerializationInfo.
Перегрузки
| AddValue(String, Object, Type) |
Добавляет значение в хранилище SerializationInfo, где |
| 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 -> unitPublic Sub AddValue (name As String, value As Object, type As Type)Параметры
- name
- String
Имя для связи со значением, которое можно десериализовать позже.
- value
- Object
Сериализуемое значение. Любой потомок этого объекта автоматически реализуется.
- type
- Type
Type для связи с текущим объектом. Этот параметр всегда должен являться типом самого объекта или одним из его базовых классов.
Исключения
Если name или type равны null.
С параметром 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 -> unitPublic Sub AddValue (name As String, value As ULong)Параметры
- name
- String
Имя для связи со значением, которое можно десериализовать позже.
- value
- UInt64
Сериализуемое значение.
- Атрибуты
Исключения
Параметр name имеет значение null.
С параметром name уже связано значение.
Комментарии
Если два значения добавляются с именами, которые отличаются только регистром, исключение не создается, что не рекомендуется. Однако при добавлении двух значений с одинаковым именем вызовет SerializationException исключение .
Применяется к
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 -> unitPublic Sub AddValue (name As String, value As UInteger)Параметры
- name
- String
Имя для связи со значением, которое можно десериализовать позже.
- Атрибуты
Исключения
Параметр name имеет значение null.
С параметром name уже связано значение.
Комментарии
Если два значения добавляются с именами, которые отличаются только регистром, исключение не создается, что не рекомендуется. Однако при добавлении двух значений с одинаковым именем вызовет SerializationException исключение .
Применяется к
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 -> unitPublic Sub AddValue (name As String, value As UShort)Параметры
- name
- String
Имя для связи со значением, которое можно десериализовать позже.
- Атрибуты
Исключения
Параметр name имеет значение null.
С параметром name уже связано значение.
Комментарии
Если два значения добавляются с именами, которые отличаются только регистром, исключение не создается, что не рекомендуется. Однако при добавлении двух значений с одинаковым именем вызовет SerializationException исключение .
Применяется к
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 -> unitPublic Sub AddValue (name As String, value As Single)Параметры
- name
- String
Имя для связи со значением, которое можно десериализовать позже.
- value
- Single
Значение Single для сериализации.
Исключения
Параметр name имеет значение null.
С параметром name уже связано значение.
Комментарии
Если два значения добавляются с именами, которые отличаются только регистром, исключение не создается, что не рекомендуется. Однако при добавлении двух значений с одинаковым именем вызовет SerializationException исключение .
Применяется к
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 -> unitPublic Sub AddValue (name As String, value As SByte)Параметры
- name
- String
Имя для связи со значением, которое можно десериализовать позже.
- value
- SByte
Значение Sbyte для сериализации.
- Атрибуты
Исключения
Параметр name имеет значение null.
С параметром name уже связано значение.
Комментарии
Если два значения добавляются с именами, которые отличаются только регистром, исключение не создается, что не рекомендуется. Однако при добавлении двух значений с одинаковым именем вызовет SerializationException исключение .
Применяется к
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 -> unitPublic Sub AddValue (name As String, value As Object)Параметры
- name
- String
Имя для связи со значением, которое можно десериализовать позже.
- value
- Object
Сериализуемое значение. Любой потомок этого объекта автоматически реализуется.
Исключения
name имеет значение null.
С параметром name уже связано значение.
Комментарии
Объект, содержащийся в параметре value , сериализуется как тип, возвращаемый value.
Если два значения добавляются с именами, которые отличаются только регистром, исключение не создается, что не рекомендуется. Однако при добавлении двух значений с одинаковым именем вызовет SerializationException исключение .
Применяется к
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 -> unitPublic Sub AddValue (name As String, value As Long)Параметры
- name
- String
Имя для связи со значением, которое можно десериализовать позже.
- value
- Int64
Значение Int64 для сериализации.
Исключения
Параметр name имеет значение null.
С параметром name уже связано значение.
Комментарии
Если два значения добавляются с именами, которые отличаются только регистром, исключение не создается, что не рекомендуется. Однако при добавлении двух значений с одинаковым именем вызовет SerializationException исключение .
Применяется к
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 -> unitPublic Sub AddValue (name As String, value As Integer)Параметры
- name
- String
Имя для связи со значением, которое можно десериализовать позже.
Исключения
Параметр name имеет значение null.
С параметром name уже связано значение.
Комментарии
Если два значения добавляются с именами, которые отличаются только регистром, исключение не создается, что не рекомендуется. Однако при добавлении двух значений с одинаковым именем вызовет SerializationException исключение .
Применяется к
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 -> unitPublic Sub AddValue (name As String, value As Short)Параметры
- name
- String
Имя для связи со значением, которое можно десериализовать позже.
Исключения
Параметр name имеет значение null.
С параметром name уже связано значение.
Комментарии
Если два значения добавляются с именами, которые отличаются только регистром, исключение не создается, что не рекомендуется. Однако при добавлении двух значений с одинаковым именем вызовет SerializationException исключение .
Применяется к
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 -> unitPublic Sub AddValue (name As String, value As Double)Параметры
- name
- String
Имя для связи со значением, которое можно десериализовать позже.
- value
- Double
Двойное значение для сериализации.
Исключения
Параметр name имеет значение null.
С параметром name уже связано значение.
Комментарии
Если два значения добавляются с именами, которые отличаются только регистром, исключение не создается, что не рекомендуется. Однако при добавлении двух значений с одинаковым именем вызовет SerializationException исключение .
Применяется к
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 -> unitPublic Sub AddValue (name As String, value As Decimal)Параметры
- name
- String
Имя для связи со значением, которое можно десериализовать позже.
- value
- Decimal
Десятичное значение для сериализации.
Исключения
Если значение параметра name — null,
Если значение уже связано с name.
Комментарии
Если два значения добавляются с именами, которые отличаются только регистром, исключение не создается, что не рекомендуется. Однако при добавлении двух значений с одинаковым именем вызовет SerializationException исключение .
Применяется к
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 -> unitPublic Sub AddValue (name As String, value As DateTime)Параметры
- name
- String
Имя для связи со значением, которое можно десериализовать позже.
Исключения
Параметр name имеет значение null.
С параметром name уже связано значение.
Комментарии
Если два значения добавляются с именами, которые отличаются только регистром, исключение не создается, что не рекомендуется. Однако при добавлении двух значений с одинаковым именем вызовет SerializationException исключение .
Применяется к
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 -> unitPublic Sub AddValue (name As String, value As Char)Параметры
- name
- String
Имя для связи со значением, которое можно десериализовать позже.
- value
- Char
Значение символа для сериализации.
Исключения
Параметр name имеет значение null.
С параметром name уже связано значение.
Комментарии
Если два значения добавляются с именами, которые отличаются только регистром, исключение не создается, что не рекомендуется. Однако при добавлении двух значений с одинаковым именем вызовет SerializationException исключение .
Применяется к
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 -> unitPublic Sub AddValue (name As String, value As Byte)Параметры
- name
- String
Имя для связи со значением, которое можно десериализовать позже.
- value
- Byte
Значение байта для сериализации.
Исключения
Параметр name имеет значение null.
С параметром name уже связано значение.
Комментарии
Если два значения добавляются с именами, которые отличаются только регистром, исключение не создается, что не рекомендуется. Однако при добавлении двух значений с одинаковым именем вызовет SerializationException исключение .
Применяется к
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 -> unitPublic Sub AddValue (name As String, value As Boolean)Параметры
- name
- String
Имя для связи со значением, которое можно десериализовать позже.
- value
- Boolean
Логическое значение для сериализации.
Исключения
Параметр name имеет значение null.
С параметром 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
