XmlArrayAttribute.IsNullable Egenskap

Definition

Hämtar eller anger ett värde som anger om XmlSerializer måste serialisera en medlem som en tom XML-tagg med xsi:nil attributet inställt på 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

Egenskapsvärde

true XmlSerializer om genererar xsi:nil attributet, annars . false

Exempel

Följande exempel innehåller två matriser: en med IsNullable egenskapen inställd på trueoch en annan med IsNullable egenskapen inställd på 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

Kommentarer

Med XML-schemaspecifikationen för strukturer kan ett XML-dokument uttryckligen signalera att ett elements innehåll saknas. Ett sådant element innehåller attributet xsi:nil inställt på true. Mer information finns i World Wide Web Consortium-specifikationen med titeln XML-schema del 1: Strukturer.

Om egenskapen IsNullable är inställd på truexsi:nil genereras attributet för klassmedlemmar som har angetts till null. Om du till exempel anger ett fält med namnet MyStringArray till nullXmlSerializer genererar följande XML-kod.

<MyStringArray xsi:nil = "true" />

Om egenskapen IsNullable är falsegenereras inget XML-element.

Note

Du kan inte tillämpa egenskapen på IsNullable en medlem som har angetts som en värdetyp eftersom en värdetyp inte kan innehålla null.

Gäller för