XmlArrayAttribute.IsNullable Vlastnost

Definice

Obor názvů:

System.Xml.Serialization

Sestavení:

System.Xml.XmlSerializer.dll

Source:

XmlArrayAttribute.cs

Získá nebo nastaví hodnotu, která označuje, zda XmlSerializer musí serializovat člen jako prázdnou značku XML s atributem xsi:nil 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 , v opačném případě false.

Příklady

Následující příklad obsahuje dvě pole: jedno s IsNullable vlastností nastavenou na truea druhé s vlastností nastavenou 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

Poznámky

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

IsNullable Pokud je vlastnost nastavená na true, xsi:nil vygeneruje se atribut pro členy třídy, kteří byli nastaveni na nullhodnotu . Pokud například nastavíte pole s názvem MyStringArray na null, vygeneruje XmlSerializer následující kód XML.

<MyStringArray xsi:nil = "true" />  

IsNullable Pokud je falsevlastnost , není vygenerován žádný element XML.

Poznámka

Vlastnost nelze použít IsNullable na člen zadaný jako typ hodnoty, protože typ hodnoty nemůže obsahovat null.