XmlElementAttribute.IsNullable Właściwość

Definicja

Przestrzeń nazw:

System.Xml.Serialization

Zestawy:

netstandard.dll, System.Xml.ReaderWriter.dll

Źródło:

XmlElementAttribute.cs

Pobiera lub ustawia wartość wskazującą, czy XmlSerializer element członkowski musi null serializować jako pusty tag z atrybutem ustawionym xsi:nil na truewartość .

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

Wartość właściwości

Boolean

true XmlSerializer jeśli element generuje xsi:nil atrybut ; w przeciwnym razie false.

Przykłady

W poniższym przykładzie przedstawiono pole z zastosowanym XmlElementAttribute do niego polem, a właściwość ustawiona IsNullable na falsewartość .

public class MyClass
{
   [XmlElement(IsNullable = false)]
   public string Group;
}

Public Class MyClass1
    <XmlElement(IsNullable := False)> Public Group As String
End Class

Uwagi

Specyfikacja schematu XML dla struktur umożliwia dokumentowi XML jawne sygnalizowanie braku zawartości elementu. Taki element zawiera atrybut xsi:nil ustawiony na truewartość . Aby uzyskać więcej informacji, zobacz specyfikację World Wide Web Consortium, XML Schema Part 1: Structures.

IsNullable Jeśli właściwość jest ustawiona na true, xsi:nil atrybut jest generowany dla składowych klasy, które zostały ustawione na null. Jeśli na przykład ustawisz pole o nazwie MyStringArray na null, XmlSerializer program generuje następujący kod XML.

<MyStringArray xsi:nil = "true" />

IsNullable Jeśli właściwość ma falsewartość , żaden element XML nie jest generowany dla składowych klasy, które zostały ustawione na null.

Uwaga / Notatka

Nie można zastosować IsNullable właściwości do elementu członkowskiego wpisanego jako typ wartości, ponieważ typ wartości nie może zawierać nullelementu . Ponadto nie można ustawić tej właściwości na false wartość dla typów wartości dopuszczanych do wartości null. Gdy takie typy to null, zostaną zserializowane, ustawiając wartość xsi:nil .true