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.
Ruft einen Wert ab, der angibt, ob XmlSerializer einen Member, der auf null festgelegt ist, als leeres Tag, dessen xsi:nil-Attribut auf true festgelegt ist, serialisieren muss, oder legt diesen fest.
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 XmlSerializer das xsi:nil-Attribut generiert, andernfalls false.
Beispiele
Das folgende Beispiel zeigt ein Feld mit der XmlElementAttribute Anwendung darauf, und die IsNullable eigenschaft auf false.
public ref class MyClass
{
public:
[XmlElement(IsNullable=false)]
String^ Group;
};
public class MyClass
{
[XmlElement(IsNullable = false)]
public string Group;
}
Public Class MyClass1
<XmlElement(IsNullable := False)> Public Group As String
End Class
Hinweise
Die XML-Schemaspezifikation für Strukturen ermöglicht es einem XML-Dokument explizit zu 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-Schemateil 1: Strukturen.
Wenn die IsNullable Eigenschaft auf true"Festgelegt" festgelegt ist, wird das xsi:nil Attribut für Klassenelemente generiert, auf die festgelegt nullwurden. Wenn Sie beispielsweise ein Feld mit dem Namen MyStringArray nullfestlegen, generiert der XmlSerializer folgende XML-Code.
<MyStringArray xsi:nil = "true" />
Wenn die IsNullable Eigenschaft lautet false, wird kein XML-Element für Klassenelemente generiert, auf die festgelegt nullwurden.
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 trueauf .