XmlArrayAttribute.IsNullable Свойство

Определение

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

System.Xml.Serialization

Сборка:

System.Xml.XmlSerializer.dll

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

XmlArrayAttribute.cs

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

Примеры

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

public ref class MyClass
{
public:

   [XmlArray(IsNullable=true)]
   array<String^>^IsNullableIsTrueArray;

   [XmlArray(IsNullable=false)]
   array<String^>^IsNullableIsFalseArray;
};

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 Под названием XML-схема, часть 1: структуры.

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

<MyStringArray xsi:nil = "true" />  

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

Примечание

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