XmlElementAttribute.IsNullable Tulajdonság

Definíció

Névtér:

System.Xml.Serialization

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XmlElementAttribute.cs

Lekéri vagy beállítja azt az értéket, amely jelzi, hogy a XmlSerializer tagnak üres címkeként kell-e szerializálnia null egy tagotxsi:nil, és az attribútum értéke a true következő.

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

Tulajdonság értéke

Boolean

trueha a XmlSerializer rendszer létrehozza az xsi:nil attribútumot; ellenkező esetben. false

Példák

Az alábbi példa egy olyan mezőt mutat be, amelynek az XmlElementAttribute alkalmazottja, a tulajdonság pedig a IsNullable következőre falsevan állítva: .

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

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

Megjegyzések

A struktúrák XML-sémaspecifikációja lehetővé teszi, hogy egy XML-dokumentum explicit módon jelezhesse, hogy egy elem tartalma hiányzik. Az ilyen elem a következő attribútumot xsi:niltruetartalmazza: . További információ: World Wide Web Consortium specifikáció, XML-séma 1. rész: Struktúrák.

Ha a IsNullable tulajdonság értéke truea következő, az xsi:nil attribútum az osztálytagok nullszámára lesz létrehozva. Ha például egy névvel ellátott MyStringArraynullmezőt állít be, a XmlSerializer következő XML-kódot hozza létre.

<MyStringArray xsi:nil = "true" />

Ha a IsNullable tulajdonság az false, akkor a rendszer nem hoz létre XML-elemet azoknak az osztálytagoknak, amelyek be vannak állítva null.

Note

A tulajdonság nem alkalmazható értéktípusként IsNullable beírt tagra, mert egy értéktípus nem tartalmazhat null. Emellett nem állíthatja be ezt a tulajdonságot false null értékű értéktípusokra. Ilyen típusok nullesetén a rendszer szerializálja őket a következő beállítással xsi:niltrue: .