XmlArrayAttribute.IsNullable Właściwość

Definicja

Przestrzeń nazw:

System.Xml.Serialization

Zestaw:

System.Xml.XmlSerializer.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

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

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

Przykłady

Poniższy przykład zawiera dwie tablice: jedną z właściwością ustawioną IsNullable na true, a drugą z właściwością ustawioną IsNullable na 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

Uwagi

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

Jeśli właściwość jest ustawiona IsNullable na truewartość , 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 polecenie wygeneruje następujący kod XML.

<MyStringArray xsi:nil = "true" />  

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

Uwaga

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 .