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.Gets or sets a value that indicates whether the XmlSerializer must serialize a member that is set to null as an empty tag with the xsi:nil attribute set to true.

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

true, wenn XmlSerializer das xsi:nil-Attribut generiert, andernfalls false.true if the XmlSerializer generates the xsi:nil attribute; otherwise, false.

Beispiele

Das folgende Beispiel zeigt ein Feld mit dem XmlElementAttribute , das auf das Feld angewendet IsNullable wird, und falsedie-Eigenschaft ist auf festgelegt.The following example shows a field with the XmlElementAttribute applied to it, and the IsNullable property set to 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-Schema Spezifikation für Strukturen ermöglicht einem XML-Dokument, explizit zu signalisieren, dass der Inhalt eines Elements fehlt.The XML schema specification for structures allows an XML document to explicitly signal that an element's content is missing. Ein solches Element enthält das- xsi:nil Attribut, truedas auf festgelegt ist.Such an element contains the attribute xsi:nil set to true. Weitere Informationen finden Sie in der World Wide Web Consortium Spezifikation XML Schema Part 1: Strukturen.For more information, see the World Wide Web Consortium specification, XML Schema Part 1: Structures.

Wenn die IsNullable -Eigenschaft auf truefestgelegt ist xsi:nil , wird das-Attribut für Klassenmember generiert, nulldie auf festgelegt wurden.If the IsNullable property is set to true, the xsi:nil attribute is generated for class members that have been set to null. Wenn Sie z. b. ein Feld MyStringArray mit nulldem Namen XmlSerializer auf festlegen, generiert den folgenden XML-Code.For example if you set a field named MyStringArray to null, the XmlSerializer generates the following XML code.

<MyStringArray xsi:nil = "true" />  

Wenn die IsNullable -Eigenschaft falseist, wird kein XML-Element für Klassenmember generiert, die nullauf festgelegt wurden.If the IsNullable property is false, no XML element is generated for class members that have been set to null.

Hinweis

Die Eigenschaft kann nicht IsNullable auf einen Member angewendet werden, der als Werttyp typisiert ist, nullda ein Werttyp nicht enthalten darf.You cannot apply the IsNullable property to a member typed as a value type because a value type cannot contain null. Darüber hinaus können Sie diese Eigenschaft nicht auf false für Werte zulässt-Werttypen festlegen.Additionally, you cannot set this property to false for nullable value types. Wenn solche Typen sind null, werden Sie serialisiert, indem auf xsi:nil truefestgelegt wird.When such types are null, they will be serialized by setting xsi:nil to true.

Gilt für: