XmlElementAttribute.IsNullable Свойство

Определение

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

System.Xml.Serialization

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

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

XmlElementAttribute.cs

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

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

Значение < a0/>, если атрибут создается; в противном случае .

Примеры

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

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. Дополнительные сведения см. в спецификации консорциума Всемирного веб-консорциума, часть 1: структуры схемы XML.

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

<MyStringArray xsi:nil = "true" />

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

Замечание

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