Teilen über


XmlElementAttribute.IsNullable Eigenschaft

Definition

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, set
Public Property IsNullable As Boolean

Eigenschaftswert

Boolean

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 .

Gilt für