XmlArrayAttribute.IsNullable Właściwość

Definicja

Przestrzeń nazw:

System.Xml.Serialization

Zestawy:

netstandard.dll, System.Xml.XmlSerializer.dll

Źródło:

XmlArrayAttribute.cs

Pobiera lub ustawia wartość wskazującą, czy XmlSerializer element członkowski musi serializować jako pusty tag XML 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

Poniższy przykład zawiera dwie tablice: jedną z właściwością IsNullable ustawioną na true, a drugą z właściwością ustawioną IsNullable na false.

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

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 zatytułowaną XML Schema Part 1: Structures (Schemat XML — część 1: struktury).

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 zostanie wygenerowany następujący kod XML.

<MyStringArray xsi:nil = "true" />

IsNullable Jeśli właściwość ma falsewartość , nie jest generowany żaden element XML.

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 .