XmlArrayAttribute.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 als een lege XML-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
Het volgende voorbeeld bevat twee matrices: een met de IsNullable eigenschap ingesteld op true, en een andere met de IsNullable eigenschap ingesteld op 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
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 met de titel 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.
Note
U kunt de IsNullable eigenschap niet toepassen op een lid dat is getypt als een waardetype omdat een waardetype niet kan bevatten null.
