XmlElementAttribute.IsNullable Właściwość

Definicja

Przestrzeń nazw:

System.Xml.Serialization

Zestaw:

System.Xml.XmlSerializer.dll

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Pobiera lub ustawia wartość wskazującą, czy XmlSerializer element członkowski musi serializować element członkowski ustawiony null na 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

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

Przykłady

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

public ref class MyClass
{
public:

   [XmlElement(IsNullable=false)]
   String^ Group;
};

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 true. Aby uzyskać więcej informacji, zobacz specyfikację world wide web consortium, 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 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 dla składowych klasy, które zostały ustawione na null.

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 . 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 przez ustawienie wartości xsi:nil true.