XmlArrayAttribute.IsNullable Tulajdonság

Definíció

Névtér:

System.Xml.Serialization

Szerelvények:

netstandard.dll, System.Xml.XmlSerializer.dll

Forrás:

XmlArrayAttribute.cs

Lekéri vagy beállít egy értéket, amely jelzi, hogy a XmlSerializer tagnak üres XML-címkeként kell-e szerializálnia egy tagot, és az attribútum értéke a xsi:nil következő 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

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 két tömböt tartalmaz: az egyikben a IsNullable tulajdonság értéke true, a másik pedig a IsNullable tulajdonság értéke 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

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ókért lásd a World Wide Web Consortium XML-séma 1. rész: Struktúrák című specifikációját.

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, a rendszer nem hoz létre XML-elemet.

Note

A tulajdonság nem alkalmazható értéktípusként IsNullable beírt tagra, mert egy értéktípus nem tartalmazhat null.