XmlElementAttribute.IsNullable Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger ett värde som anger om XmlSerializer måste serialisera en medlem som är inställd null på som en tom 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, setPublic Property IsNullable As BooleanEgenskapsvärde
true
XmlSerializer om genererar xsi:nil attributet, annars . false
Exempel
I följande exempel visas ett fält med tillämpat XmlElementAttribute på det och egenskapen IsNullable är inställd på false.
public class MyClass
{
[XmlElement(IsNullable = false)]
public string Group;
}
Public Class MyClass1
<XmlElement(IsNullable := False)> Public Group 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, 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 för klassmedlemmar som har angetts till null.
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. Dessutom kan du inte ange den här egenskapen till false för null-värdetyper. När sådana typer är nullkommer de att serialiseras genom att ange xsi:nil till true.
