XmlElementAttribute.IsNullable Vlastnost

Definice

Obor názvů:

System.Xml.Serialization

Sestavení:

System.Xml.XmlSerializer.dll

Sestavení:

System.Xml.ReaderWriter.dll

Sestavení:

System.Xml.dll

Sestavení:

netstandard.dll

Získá nebo nastaví hodnotu, která označuje, zda XmlSerializer musí serializovat člen, který je nastaven jako null prázdná značka s atributem nastaven na xsi:nil 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 XmlSerializer xsi:nil atribut; falsev opačném případě .

Příklady

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

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

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 schématu XML 1: 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 pojmenované MyStringArray na null, XmlSerializer vygeneruje následující kód XML.

<MyStringArray xsi:nil = "true" />  

Pokud je IsNullable falsevlastnost , není generová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 typy hodnot s možnou false hodnotou null. Pokud jsou nulltyto typy , budou serializovány nastavením xsi:nil na true.