XmlArrayAttribute.IsNullable Свойство

Определение

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

System.Xml.Serialization

Сборки:

netstandard.dll, System.Xml.XmlSerializer.dll

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

XmlArrayAttribute.cs

Возвращает или задает значение, указывающее, должен ли XmlSerializer сериализовать элемент в виде пустого XML-тега с заданным атрибутом 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/>, если атрибут создается; в противном случае .

Примеры

В следующем примере содержится два массива: один со свойством IsNullable , равным true, а другой — свойству IsNullablefalse.

public class MyClass
{
   [XmlArray (IsNullable = true)]
   public string [] IsNullableIsTrueArray;

   [XmlArray (IsNullable = false)]
   public string [] IsNullableIsFalseArray;
}

Public Class MyClass1
    <XmlArray(IsNullable := True)> _
    Public IsNullableIsTrueArray() As String

    <XmlArray(IsNullable := False)> _
    Public IsNullableIsFalseArray() As String
End Class

Комментарии

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

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

<MyStringArray xsi:nil = "true" />

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

Замечание

Невозможно применить IsNullable свойство к элементу, типизированному как типу значения, так как тип значения не может содержать null.