Edit

SoapElementAttribute.IsNullable Property

  • Reference

Definition

Namespace:
System.Xml.Serialization
Assembly:
System.Xml.XmlSerializer.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Source:
SoapElementAttribute.cs
Source:
SoapElementAttribute.cs
Source:
SoapElementAttribute.cs

Gets or sets a value that indicates whether the XmlSerializer must serialize a member that has the xsi:null attribute set to "1".

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

Property Value

Boolean

true if the XmlSerializer generates the xsi:null attribute; otherwise, false.

Remarks

The XML schema specification for structures allows an XML document to explicitly signal that an element's content is missing. Such an element contains the attribute xsi:null set to "1". For more information, see the World Wide Web Consortium specification named XML Schema Part 1: Structures.

If the IsNullable property is set to true, the xsi:null attribute is generated for class members that have been set to null. For example, if you set a field named MyStringArray to null, the XmlSerializer generates the following XML code.

<MyStringArray xsi:null = "1" />

If the IsNullable property is false, no XML element is generated.

Note

You cannot apply the IsNullable property to a member typed as a value type because a value type cannot contain null.

Applies to