XmlArrayAttribute.IsNullable Vlastnost

Definice

Obor názvů:

System.Xml.Serialization

Sestavení:

netstandard.dll, System.Xml.XmlSerializer.dll

Zdroj:

XmlArrayAttribute.cs

Získá nebo nastaví hodnotu, která určuje, zda XmlSerializer musí serializovat člena jako prázdnou značku XML s xsi:nil atributem nastaveným 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 obsahuje dvě pole: jedno s vlastností nastavenou IsNullable na truea další s vlastností nastavenou 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

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 naleznete ve specifikaci konsorcia World Wide Web Consortium s názvem XML Schema Part 1: Structures.

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 MyStringArraynullna , XmlSerializer vygeneruje následující kód XML.

<MyStringArray xsi:nil = "true" />

Pokud je IsNullablefalsevlastnost , není generován žádný element XML.

Poznámka:

Vlastnost nelze použít IsNullable u člena zadaného jako typ hodnoty, protože typ hodnoty nemůže obsahovat null.