XmlElementAttribute.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 serialisieren muss, das als leeres Tag festgelegt null ist, auf das das xsi:nil Attribut festgelegt trueist.
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 zeigt ein Feld mit dem XmlElementAttribute angewendeten Feld und die Eigenschaft, auf falsedie IsNullable sie festgelegt ist.
public class MyClass
{
[XmlElement(IsNullable = false)]
public string Group;
}
Public Class MyClass1
<XmlElement(IsNullable := False)> Public Group 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, 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 für Klassenmber generiert, die auf null.
Hinweis
Sie können die Eigenschaft nicht auf ein Element anwenden, das IsNullable als Werttyp eingegeben wurde, da ein Werttyp nicht enthalten nullkann. Darüber hinaus können Sie diese Eigenschaft false nicht für Nullwertetypen festlegen. Wenn solche Typen vorhanden sind null, werden sie durch Festlegen xsi:nil auf true.
