XmlElementAttribute.IsNullable Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het XmlSerializer lid moet worden geserialiseerd dat is ingesteld null als een lege tag met het xsi:nil kenmerk ingesteld op 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 BooleanWaarde van eigenschap
true als het XmlSerializer kenmerk wordt gegenereerd xsi:nil ; falseanders.
Voorbeelden
In het volgende voorbeeld ziet u een veld met de XmlElementAttribute toegepaste waarde en de IsNullable eigenschap ingesteld op false.
public class MyClass
{
[XmlElement(IsNullable = false)]
public string Group;
}
Public Class MyClass1
<XmlElement(IsNullable := False)> Public Group As String
End Class
Opmerkingen
Met de XML-schemaspecificatie voor structuren kan een XML-document expliciet aangeven dat de inhoud van een element ontbreekt. Een dergelijk element bevat het kenmerk xsi:nil dat is ingesteld op true. Zie de specificatie van het World Wide Web Consortium, XML-schema deel 1: Structuren voor meer informatie.
Als de IsNullable eigenschap is ingesteld op true, wordt het xsi:nil kenmerk gegenereerd voor klasseleden die zijn ingesteld op null. Als u bijvoorbeeld een veld met de naam MyStringArraynullinstelt, wordt de XmlSerializer volgende XML-code gegenereerd.
<MyStringArray xsi:nil = "true" />
Als de IsNullable eigenschap is false, wordt er geen XML-element gegenereerd voor klasseleden die zijn ingesteld op null.
Note
U kunt de IsNullable eigenschap niet toepassen op een lid dat is getypt als een waardetype omdat een waardetype niet kan bevatten null. Daarnaast kunt u deze eigenschap false niet instellen op null-waardetypen. Wanneer dergelijke typen zijn null, worden ze geserialiseerd door in te stellen xsi:nil op true.
