XmlArrayAttribute.IsNullable Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das XmlSerializer Element als leeres XML-Tag serialisieren muss, auf das das xsi:nil Attribut festgelegt ist 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 BooleanEigenschaftswert
true wenn das XmlSerializerxsi:nil Attribut generiert wird; falseandernfalls .
Beispiele
Das folgende Beispiel enthält zwei Arrays: eine mit der Eigenschaft, auf die IsNullable die Eigenschaft festgelegt ist true, und eine mit der IsNullable Eigenschaft auf 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
Hinweise
Mit der XML-Schemaspezifikation für Strukturen kann ein XML-Dokument explizit signalisieren, dass der Inhalt eines Elements fehlt. Ein solches Element enthält das Attribut xsi:nil , auf das truefestgelegt ist. Weitere Informationen finden Sie in der Spezifikation des World Wide Web Consortium mit dem Titel "XML Schema Part 1: Structures".
Wenn die IsNullable Eigenschaft auf true festgelegt ist, wird das xsi:nil Attribut für Klassenmmber generiert, die auf null. Wenn Sie beispielsweise ein Feld mit dem Namen MyStringArraynullfestlegen, generiert der XmlSerializer folgende XML-Code.
<MyStringArray xsi:nil = "true" />
Wenn die IsNullable Eigenschaft lautet false, wird kein XML-Element generiert.
Hinweis
Sie können die Eigenschaft nicht auf ein Element anwenden, das IsNullable als Werttyp eingegeben wurde, da ein Werttyp nicht enthalten nullkann.
