XmlElementAttribute.IsNullable Свойство

Определение

Получает или задает значение, которое указывает, должен ли XmlSerializer сериализовать члена, имеющего значение null, в качестве пустого тега с атрибутом xsi:nil со значением true.

public:
 property bool IsNullable { bool get(); void set(bool value); };
public bool IsNullable { get; set; }
member this.IsNullable : bool with get, set
Public Property IsNullable As Boolean

Значение свойства

Boolean

true, если XmlSerializer создает атрибут xsi:nil; в противном случае — false.

Примеры

В следующем примере показано поле с примененным XmlElementAttribute к нему полем и свойством IsNullable , равным false.

public ref class MyClass
{
public:

   [XmlElement(IsNullable=false)]
   String^ Group;
};
public class MyClass
{
   [XmlElement(IsNullable = false)]
   public string Group;
}
Public Class MyClass1
    <XmlElement(IsNullable := False)> Public Group As String
End Class

Комментарии

Спецификация XML-схемы для структур позволяет XML-документу явно сигнализировать о том, что содержимое элемента отсутствует. Такой элемент содержит атрибут xsi:nil , равный true. Дополнительные сведения см. в спецификации консорциума World Wide Web Consortium, часть 1. Структура.

IsNullable Если свойство имеет значениеtrue, xsi:nil атрибут создается для членов класса, для которых задано значение null. Например, если задать для поля имя MyStringArray null, XmlSerializer создается следующий XML-код.

<MyStringArray xsi:nil = "true" />  

IsNullable Если свойство имеет значениеfalse, xml-элемент не создается для членов класса, для которых задано значение null.

Примечание

Невозможно применить IsNullable свойство к члену, типизированному как типу значения, так как тип значения не может содержать null. Кроме того, это свойство false нельзя задать для типов значений, допускающих значение NULL. Если такие типы являются null, они будут сериализованы путем установки значения xsi:nil true.

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