SoapElementAttribute.IsNullable Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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
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
.NET