XmlElementAttribute.IsNullable Vlastnost

Definice

Obor názvů:

System.Xml.Serialization

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlElementAttribute.cs

Získá nebo nastaví hodnotu, která určuje, zda XmlSerializer musí serializovat člen, který je nastaven jako null prázdná značka s xsi:nil atributem nastavena na 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

Hodnota vlastnosti

Boolean

true pokud vygeneruje XmlSerializerxsi:nil atribut; jinak , false.

Příklady

Následující příklad ukazuje pole s použitým XmlElementAttribute na něj a vlastnost nastavena IsNullable na false.

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

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

Poznámky

Specifikace schématu XML pro struktury umožňuje dokumentu XML explicitně signalizovat, že chybí obsah elementu. Takový prvek obsahuje atribut xsi:nil nastavený na true. Další informace najdete ve specifikaci konsorcia World Wide Web Consortium, část 1 schématu XML: Struktury.

IsNullable Pokud je vlastnost nastavena na true, xsi:nil atribut je generován pro členy třídy, které byly nastaveny na null. Pokud například nastavíte pole s názvem MyStringArraynull, vygeneruje XmlSerializer následující kód XML.

<MyStringArray xsi:nil = "true" />

IsNullable Pokud je falsevlastnost , není vygenerován žádný element XML pro členy třídy, které byly nastaveny na null.

Poznámka:

Vlastnost nelze použít IsNullable u člena zadaného jako typ hodnoty, protože typ hodnoty nemůže obsahovat null. Kromě toho nelze tuto vlastnost nastavit pro false typy hodnot s možnou hodnotou null. Pokud jsou takové typy null, budou serializovány nastavením xsi:nil na true.